switch_heading
Seedance 2.5 API 문서
API v3로 Seedance 2.5와 Seedance 2.5 Flash 비디오를 생성하세요: 텍스트-투-비디오, 레퍼런스 이미지·비디오·오디오, 첫/마지막 프레임, 비디오 편집, 4K 출력.
API v3는 Seedance 2.5 전용의 별도 엔드포인트입니다. 기존 /v1 및 /v2 통합은 이전과 동일하게 계속 작동하며, Seedance 2.5가 필요할 때만 /v3로 전환하세요.
빠른 시작
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
인증
모든 API 요청은 Authorization 헤더에 Bearer 토큰이 필요합니다.
중요: 대시보드의 API Keys 페이지에서 API 키를 발급받으세요. 서버에만 보관하고 브라우저 코드에는 절대 포함하지 마세요. → API 키 발급받기
| 1 | Authorization: Bearer YOUR_API_KEY |
생성 모드
| 모드 | 전송할 필드 |
|---|---|
| 텍스트-투-비디오 | prompt + aspect_ratio |
| 레퍼런스 생성(이미지, 비디오, 오디오) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| 첫 / 마지막 프레임 | prompt + first_frame_url (+ last_frame_url) |
| 비디오 편집 | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
가격(크레딧)
크레딧은 비디오 초 단위로 청구되며 모델, 해상도, 레퍼런스 비디오 전송 여부에 따라 달라집니다. 금액은 작업 생성 시 차감되며 실패 시 자동으로 환불됩니다.
크레딧 충전이 필요하신가요? → 가격 페이지에서 충전하기. 1 USD = 100 크레딧.
Seedance 2.5
최고 품질. 480p, 720p, 네이티브 4K 지원.
| 해상도 | 입력 | 요율 | 예시 |
|---|---|---|---|
| 480p | 텍스트 / 이미지 / 오디오 | 28 크레딧 / 초 | 출력 10초 = 280 크레딧 |
| 480p | 레퍼런스 비디오 포함 | 17 크레딧 / 초 | 레퍼런스 5초 + 출력 10초 = 255 크레딧 |
| 720p | 텍스트 / 이미지 / 오디오 | 63 크레딧 / 초 | 출력 10초 = 630 크레딧 |
| 720p | 레퍼런스 비디오 포함 | 38 크레딧 / 초 | 레퍼런스 5초 + 출력 10초 = 570 크레딧 |
| 4k | 텍스트 / 이미지 / 오디오 | 251 크레딧 / 초 | 출력 10초 = 2510 크레딧 |
| 4k | 레퍼런스 비디오 포함 | 155 크레딧 / 초 | 레퍼런스 5초 + 출력 10초 = 2325 크레딧 |
Seedance 2.5 Flash
더 빠르고 저렴. 480p와 720p 지원.
| 해상도 | 입력 | 요율 | 예시 |
|---|---|---|---|
| 480p | 텍스트 / 이미지 / 오디오 | 18.5 크레딧 / 초 | 출력 10초 = 185 크레딧 |
| 480p | 레퍼런스 비디오 포함 | 11.5 크레딧 / 초 | 레퍼런스 5초 + 출력 10초 = 173 크레딧 |
| 720p | 텍스트 / 이미지 / 오디오 | 41 크레딧 / 초 | 출력 10초 = 410 크레딧 |
| 720p | 레퍼런스 비디오 포함 | 25.5 크레딧 / 초 | 레퍼런스 5초 + 출력 10초 = 383 크레딧 |
reference_video_urls를 보내면 레퍼런스 비디오 초에는 더 낮은 비디오 입력 요율이 적용되고 출력 초가 더해집니다. 비디오 편집(duration -1)은 입력 비디오 길이의 2배로 청구됩니다. 합계는 정수 크레딧으로 올림됩니다.
API 엔드포인트
/v3/generateSeedance 2.5 또는 Seedance 2.5 Flash 작업을 시작합니다. 호출은 즉시 task_id를 반환하며, /v3/status를 폴링하거나 callback_url을 전달해 결과를 받으세요.
요청 본문
텍스트 프롬프트(필수, 최대 5000자).
seedance-2.5(기본값) 또는 seedance-2.5-flash. Defaults to seedance-2.5.
출력 길이(초): 4에서 30 사이의 정수. 비디오 편집에는 -1을 사용하며, 출력은 입력 비디오의 길이를 유지합니다. Defaults to 5.
Seedance 2.5: 480p, 720p 또는 4k. Seedance 2.5 Flash: 480p 또는 720p. 1080p는 지원되지 않습니다. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 또는 adaptive. 비디오 편집에는 adaptive가 필요합니다. Defaults to 16:9.
레퍼런스 이미지 URL 최대 4개(http/https). 각 이미지를 어떻게 사용할지 프롬프트에 설명하세요.
첫 프레임으로 사용할 이미지 URL. image_urls, reference_video_urls, reference_audio_urls와 함께 사용할 수 없습니다.
마지막 프레임으로 사용할 선택적 이미지 URL. first_frame_url이 필요합니다.
레퍼런스 비디오 URL 최대 3개, 합계 30초. 비디오 편집에는 길이가 4초에서 30초 사이인 비디오 정확히 1개를 보내세요.
레퍼런스 오디오 URL 최대 3개. 예: 음악이나 보이스 트랙.
비디오와 함께 사운드트랙을 생성합니다. Defaults to true.
모델이 프롬프트 속 대상을 웹에서 검색하도록 허용합니다. Defaults to false.
작업 완료 시 호출되는 선택적 웹훅(공개 URL, localhost는 허용되지 않음).
선택 사항: 결과를 공개 갤러리에 표시하도록 허용합니다.
텍스트-투-비디오
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
레퍼런스 이미지 + 오디오
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
첫/마지막 프레임(Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
비디오 편집
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
4K 출력
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
응답
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusstatus가 SUCCESS 또는 FAILED가 될 때까지 task_id로 폴링하세요. 여기에는 /v3/generate로 생성된 작업만 반환됩니다.
쿼리 파라미터
POST /v3/generate가 반환하는 작업 ID(sd25로 끝남).
요청 예시
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: status가 SUCCESS이면 data.response는 비디오 URL 배열입니다. 첫 번째 URL에는 data.response[0]을 사용하세요. 보관이 필요하면 파일을 다운로드해 저장하세요.
| 1 | const videoUrl = data.response[0]; |
응답
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
API 플레이그라운드
브라우저에서 API를 사용해 보세요. YOUR_API_KEY를 실제 키로 바꾸세요. 성공한 호출은 모두 과금됩니다.
오류 코드
| Status | 발생 시점 |
|---|---|
| 400 잘못된 요청 | 파라미터가 누락되었거나 잘못되었습니다. 예: 지원되지 않는 model, resolution, aspect_ratio, duration 또는 미디어 URL. 메시지에 어떤 파라미터인지 표시됩니다. |
| 401 인증되지 않음 | API 키가 없거나 유효하지 않습니다. |
| 402 | 이 작업에 필요한 크레딧이 부족합니다. |
| 404 찾을 수 없음 | 작업이 존재하지 않거나 /v3/generate로 생성되지 않았습니다. |
| 500 내부 서버 오류 | 서버 오류입니다. 나중에 다시 시도하세요. 실패한 작업은 자동으로 환불됩니다. |