LogoSeedance API

Seedance 2.0 API 문서

Seedance 2.0 비디오 생성 API를 애플리케이션에 통합하기 위한 완전 가이드.

API v1.0 Base URL: https://seedanceapi.org/v1

빠른 시작

bash
1curl -X POST 'https://seedanceapi.org/v1/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "8"
9 }'

인증

모든 API 요청은 Authorization 헤더에서 Bearer 토큰을 사용한 인증이 필요합니다.

중요: 대시보드의 API Keys 페이지에서 API 키를 가져올 수 있습니다. → API 키 가져오기

http
1Authorization: Bearer YOUR_API_KEY

요금

480p

480p 해상도

빠른 생성, 미리보기 및 초안에 적합

길이오디오 없음오디오 포함
4s8 credits ($0.04)14 credits ($0.07)
8s14 credits ($0.07)28 credits ($0.14)
12s19 credits ($0.095)38 credits ($0.19)
720p

720p 해상도

고품질 출력, 프로덕션에 권장

길이오디오 없음오디오 포함
4s14 credits ($0.07)28 credits ($0.14)
8s28 credits ($0.14)56 credits ($0.28)
12s42 credits ($0.21)84 credits ($0.42)

API 엔드포인트

POST/v1/generate

Seedance 2.0 모델로 새 비디오 생성 작업을 생성합니다. 텍스트-비디오 및 이미지-비디오 모드를 지원합니다.

요청 본문

Body ParametersJSON
prompt:string

생성할 비디오의 텍스트 설명 (최대 2000자)

aspect_ratio:optional string

출력 종횡비. 지원: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

비디오 해상도: 480p 또는 720p Defaults to 720p.

duration:optional string

비디오 길이(초): 4, 8 또는 12 Defaults to 8.

generate_audio:optional boolean

비디오에 대한 AI 오디오 생성 활성화 Defaults to false.

fixed_lens:optional boolean

카메라를 고정하여 모션 블러 감소 Defaults to false.

image_urls:optional string[]

이미지-비디오 생성을 위한 참조 이미지 URL 배열 (최대 1개)

callback_url:optional string

비동기 상태 알림을 위한 Webhook URL. 공개적으로 접근 가능해야 합니다.

텍스트에서 비디오

json
1{
2 "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8"
6}

이미지에서 비디오

json
1{
2 "prompt": "The character slowly turns and smiles at the camera",
3 "image_urls": [
4 "https://example.com/my-image.jpg"
5 ],
6 "aspect_ratio": "16:9",
7 "resolution": "720p",
8 "duration": "4"
9}

오디오 생성 포함

json
1{
2 "prompt": "A peaceful river flowing through a forest with birds singing",
3 "aspect_ratio": "16:9",
4 "resolution": "720p",
5 "duration": "8",
6 "generate_audio": true,
7 "fixed_lens": true
8}

응답

Task created successfully

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "seed15abc123def456pro",
6 "status": "IN_PROGRESS"
7 }
8}
GET/v1/status

비디오 생성 작업의 상태를 확인하고 완료 시 결과를 가져옵니다.

쿼리 매개변수

Body ParametersJSON
task_id:string

생성 엔드포인트에서 반환된 고유 작업 ID

요청 예시

bash
1curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: 상태 API의 response 필드는 비디오 URL 배열입니다. data.response[0]에 직접 접근하여 비디오 URL을 가져올 수 있습니다.

javascript
1// Extract video URL from response
2const videoUrl = data.response[0];

응답

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "seed15abc123def456pro",
6 "status": "SUCCESS",
7 "consumed_credits": 28,
8 "created_at": "2026-02-07T10:30:00Z",
9 "request": {
10 "prompt": "A majestic eagle soaring through golden sunset clouds",
11 "aspect_ratio": "16:9",
12 "resolution": "720p",
13 "duration": "8"
14 },
15 "response": [
16 "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17 ],
18 "error_message": null
19 }
20}

API 플레이그라운드

브라우저에서 직접 API를 테스트합니다. YOUR_API_KEY를 실제 API 키로 교체하세요.

API 테스트 환경POST

오류 코드

StatusCodeDescription
400 잘못된 요청INVALID_PROMPT프롬프트가 유효하지 않거나 비어있습니다
400 잘못된 요청INVALID_ASPECT_RATIO지원되지 않는 종횡비입니다
400 잘못된 요청INVALID_RESOLUTION해상도는 480p 또는 720p이어야 합니다
400 잘못된 요청INVALID_DURATION길이는 4, 8 또는 12초이어야 합니다
400 잘못된 요청TOO_MANY_IMAGESimage_urls 배열에 최대 1개의 이미지 URL이 허용됩니다
401 인증되지 않음INVALID_API_KEYAPI 키가 없거나 유효하지 않습니다
402 INSUFFICIENT_CREDITS이 작업에 크레딧이 부족합니다
404 찾을 수 없음TASK_NOT_FOUND작업 ID를 찾을 수 없거나 귀하의 계정에 속하지 않습니다
500 내부 서버 오류INTERNAL_ERROR서버 오류입니다. 나중에 다시 시도해주세요