switch_heading
Seedance 2.0 Mini API 문서
Seedance 2.0 Mini 비디오 생성 API를 애플리케이션에 통합하기 위한 완전 가이드.
빠른 시작
| 1 | curl -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 키 가져오기
| 1 | Authorization: Bearer YOUR_API_KEY |
요금
480p 해상도
초당 14.25 크레딧(요청별 올림)
| 길이 | 크레딧 |
|---|---|
| 4s | 57 credits |
| 5s | 72 credits |
| 8s | 114 credits |
| 10s | 143 credits |
| 12s | 171 credits |
| 15s | 214 credits |
720p 해상도
초당 30.75 크레딧(요청별 올림)
| 길이 | 크레딧 |
|---|---|
| 4s | 123 credits |
| 5s | 154 credits |
| 8s | 246 credits |
| 10s | 308 credits |
| 12s | 369 credits |
| 15s | 462 credits |
API 엔드포인트
/v1/generateSeedance 2.0 Mini 모델로 새 비디오 생성 작업을 생성합니다. 텍스트-비디오 및 이미지-비디오 모드를 지원합니다.
요청 본문
생성할 비디오의 텍스트 설명 (최대 2000자)
출력 화면 비율. 지원: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.
비디오 해상도: 480p 또는 720p Defaults to 720p.
동영상 길이(초): 4–15 정수 Defaults to 8.
AI 오디오 생성 활성화(가격에 영향 없음) Defaults to false.
지원 중단 — 호환성을 위해 허용되지만 Seedance 2.0 Mini에서는 무시됩니다 Defaults to false.
이미지-비디오 생성을 위한 참조 이미지 URL 배열 (최대 1개)
비동기 상태 알림을 위한 Webhook URL. 공개적으로 접근 가능해야 합니다.
텍스트에서 비디오
| 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 | } |
이미지에서 비디오
| 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 | } |
오디오 생성 포함
| 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 | } |
응답
Task created successfully
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90abc123def456_seedance", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
/v1/status비디오 생성 작업의 상태를 확인하고 완료 시 결과를 가져옵니다.
쿼리 매개변수
생성 엔드포인트에서 반환된 고유 작업 ID
요청 예시
| 1 | curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
💡 Tip: 상태 API의 response 필드는 비디오 URL 배열입니다. data.response[0]에 직접 접근하여 비디오 URL을 가져올 수 있습니다.
| 1 | // Extract video URL from response |
| 2 | const videoUrl = data.response[0]; |
응답
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90abc123def456_seedance", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 246, |
| 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/n90abc123def456_seedance.mp4" |
| 17 | ], |
| 18 | "error_message": null |
| 19 | } |
| 20 | } |
API 플레이그라운드
브라우저에서 직접 API를 테스트합니다. YOUR_API_KEY를 실제 API 키로 교체하세요.
오류 코드
| Status | Code | Description |
|---|---|---|
| 400 잘못된 요청 | INVALID_PROMPT | 프롬프트가 유효하지 않거나 비어있습니다 |
| 400 잘못된 요청 | INVALID_ASPECT_RATIO | 지원되지 않는 종횡비입니다 |
| 400 잘못된 요청 | INVALID_RESOLUTION | 해상도는 480p 또는 720p이어야 합니다 |
| 400 잘못된 요청 | INVALID_DURATION | 길이는 4, 8 또는 12초이어야 합니다 |
| 400 잘못된 요청 | TOO_MANY_IMAGES | image_urls 배열에 최대 1개의 이미지 URL이 허용됩니다 |
| 401 인증되지 않음 | INVALID_API_KEY | API 키가 없거나 유효하지 않습니다 |
| 402 | INSUFFICIENT_CREDITS | 이 작업에 크레딧이 부족합니다 |
| 404 찾을 수 없음 | TASK_NOT_FOUND | 작업 ID를 찾을 수 없거나 귀하의 계정에 속하지 않습니다 |
| 500 내부 서버 오류 | INTERNAL_ERROR | 서버 오류입니다. 나중에 다시 시도해주세요 |