Seedance 공개 API
Seedance 동영상 및 이미지 생성 API 문서입니다.
라이브 액세스 — 이메일 인증 사용자는 설정 → API 키에서
sd_live_...Key를 만들 수 있습니다. API는 PC와 동일한 크레딧, 가격, 작업, 실패 환불 로직을 사용합니다. 모든 셀프서비스 Key에서 엄격한 요청 단위 규정 준수 제어 아래 요청마다 실제 인물 모드를 선택할 수 있습니다.
진입점
- 문서:
https://seedance2video.io/ko/docs/api - 계정:
/settings/public-api - Base URL:
https://api.seedance2video.io/v1 - OpenAPI:
https://api.seedance2video.io/v1/openapi.json
OpenAPI는 Postman, Insomnia, Bruno 또는 서버 측 클라이언트 생성기에 사용할 수 있습니다. v1은 브라우저 CORS를 허용하지 않으므로 Live Key를 프런트엔드 JavaScript에 넣지 마세요.
1단계 엔드포인트
| 기능 | 엔드포인트 |
|---|---|
| Key에 허용된 모델 조회 | GET /models |
| 동영상 생성 | POST /videos |
| 이미지 생성 | POST /images |
| 생성 상태 조회 | GET /generations/{id} |
| PC 크레딧 잔액 | GET /credits/balance |
| OpenAPI 다운로드 | GET /openapi.json |
업로드, Webhook, 취소, 사용량 목록, Test Key, 별도 API 지갑은 1단계에서 제공하지 않습니다.
핵심 규칙
Authorization: Bearer sd_live_...로 인증합니다.- 모든 생성 요청에는 안정적인
Idempotency-Key가 필요합니다. - 생성은 비동기이며 반환된
status_url만 폴링합니다. - 완료 URL은
output.urls, 동영상은output.video_url, 이미지는output.image_urls에 있습니다. - 입력은 승인된 저장소 호스트의 공개 HTTPS URL이어야 합니다. Base64,
data:, localhost, IP 주소, 임의 원격 호스트는 거부됩니다. - Provider 이름, Provider Task ID, 원본 응답, 내부 모델 ID는 반환하지 않습니다.
공개 모델은 seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2, nano-banana-pro입니다. Veo와 Lite는 제공하지 않습니다.
생성 권한이 있는 모든 Key에서 요청마다 실제 인물 모드를 선택할 수 있습니다. 세 Seedance 모델의 이미지 또는 멀티모달 동영상 모드로 제한되며 권리 확인과 고객 감사 ID가 필요합니다. 안전 제어는 항상 서버가 관리합니다.
정확한 필드는 parameters.real_person_mode: true, compliance.rights_confirmed: true, 그리고 compliance.consent_reference의 개인 정보가 아닌 감사 참조입니다.