label llms.txt open_chatgpt

Seedance 2.5 API 문서

API v3로 Seedance 2.5와 Seedance 2.5 Flash 비디오를 생성하세요: 텍스트-투-비디오, 레퍼런스 이미지·비디오·오디오, 첫/마지막 프레임, 비디오 편집, 4K 출력.

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

API v3는 Seedance 2.5 전용의 별도 엔드포인트입니다. 기존 /v1 및 /v2 통합은 이전과 동일하게 계속 작동하며, Seedance 2.5가 필요할 때만 /v3로 전환하세요.

빠른 시작

bash
1curl -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 키 발급받기

http
1Authorization: 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 크레딧.

2.5

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 크레딧
Flash

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 엔드포인트

POST/v3/generate

Seedance 2.5 또는 Seedance 2.5 Flash 작업을 시작합니다. 호출은 즉시 task_id를 반환하며, /v3/status를 폴링하거나 callback_url을 전달해 결과를 받으세요.

요청 본문

Body ParametersJSON
prompt:string

텍스트 프롬프트(필수, 최대 5000자).

model:optional string

seedance-2.5(기본값) 또는 seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

출력 길이(초): 4에서 30 사이의 정수. 비디오 편집에는 -1을 사용하며, 출력은 입력 비디오의 길이를 유지합니다. Defaults to 5.

resolution:optional string

Seedance 2.5: 480p, 720p 또는 4k. Seedance 2.5 Flash: 480p 또는 720p. 1080p는 지원되지 않습니다. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 또는 adaptive. 비디오 편집에는 adaptive가 필요합니다. Defaults to 16:9.

image_urls:optional string[]

레퍼런스 이미지 URL 최대 4개(http/https). 각 이미지를 어떻게 사용할지 프롬프트에 설명하세요.

first_frame_url:optional string

첫 프레임으로 사용할 이미지 URL. image_urls, reference_video_urls, reference_audio_urls와 함께 사용할 수 없습니다.

last_frame_url:optional string

마지막 프레임으로 사용할 선택적 이미지 URL. first_frame_url이 필요합니다.

reference_video_urls:optional string[]

레퍼런스 비디오 URL 최대 3개, 합계 30초. 비디오 편집에는 길이가 4초에서 30초 사이인 비디오 정확히 1개를 보내세요.

reference_audio_urls:optional string[]

레퍼런스 오디오 URL 최대 3개. 예: 음악이나 보이스 트랙.

generate_audio:optional boolean

비디오와 함께 사운드트랙을 생성합니다. Defaults to true.

web_search:optional boolean

모델이 프롬프트 속 대상을 웹에서 검색하도록 허용합니다. Defaults to false.

callback_url:optional string

작업 완료 시 호출되는 선택적 웹훅(공개 URL, localhost는 허용되지 않음).

public:optional boolean

선택 사항: 결과를 공개 갤러리에 표시하도록 허용합니다.

텍스트-투-비디오

json
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}

레퍼런스 이미지 + 오디오

json
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)

json
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}

비디오 편집

json
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 출력

json
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}
GET/v3/status

status가 SUCCESS 또는 FAILED가 될 때까지 task_id로 폴링하세요. 여기에는 /v3/generate로 생성된 작업만 반환됩니다.

쿼리 파라미터

Body ParametersJSON
task_id:string

POST /v3/generate가 반환하는 작업 ID(sd25로 끝남).

요청 예시

bash
1curl -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]을 사용하세요. 보관이 필요하면 파일을 다운로드해 저장하세요.

javascript
1const 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를 실제 키로 바꾸세요. 성공한 호출은 모두 과금됩니다.

API 테스트 환경POST

오류 코드

Status발생 시점
400 잘못된 요청파라미터가 누락되었거나 잘못되었습니다. 예: 지원되지 않는 model, resolution, aspect_ratio, duration 또는 미디어 URL. 메시지에 어떤 파라미터인지 표시됩니다.
401 인증되지 않음API 키가 없거나 유효하지 않습니다.
402 이 작업에 필요한 크레딧이 부족합니다.
404 찾을 수 없음작업이 존재하지 않거나 /v3/generate로 생성되지 않았습니다.
500 내부 서버 오류서버 오류입니다. 나중에 다시 시도하세요. 실패한 작업은 자동으로 환불됩니다.