자체 도구로 영상 및 이미지 생성
키를 생성하고, Bearer 인증으로 API를 호출한 후, 결과가 준비될 때까지 작업 상태를 폴링하세요. Claude Code, Codex, 및 모든 HTTP 클라이언트에서 사용할 수 있어요.
빠른 시작
1단계
키 생성
대시보드에서 API 키를 생성하세요. 키는 한 번만 표시되므로, 안전한 곳에 보관하세요.
2단계
API 호출
Bearer 키와 Idempotency-Key 헤더를 포함하여 POST 요청을 전송하세요.
3단계
결과 확인
작업 상태 엔드포인트를 폴링하여 상태가 완료 또는 실패가 될 때까지 확인한 후, 출력을 읽습니다.
인증
모든 요청은 Authorization 헤더에 Bearer API 키를 포함하여 인증됩니다.
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-requestSeedance 2 Video
텍스트, 이미지, 또는 미디어를 영상으로
작업 제출
/api/v1/video/seedance2파라미터
| 매개변수 | 유형 | 필수 | 기본 | 허용 값 |
|---|---|---|---|---|
modeGeneration mode. | string | 선택 사항 | text-to-video | text-to-videoimage-to-videomedia-to-video |
quality_tierQuality tier. | string | 선택 사항 | standard | ministandardpro |
channelRendering channel. | string | 선택 사항 | standard | standardrealwild |
promptText prompt. | string | 필수 | — | 3–10000 chars |
aspect_ratioAspect ratio. | string | 선택 사항 | 16:9 | 1:121:94:33:416:99:16adaptive |
durationClip duration. | string | 선택 사항 | 5 | 4–15 (seconds) |
resolutionOutput resolution. 1080p-plus and 4k are available on pro only. | string | 선택 사항 | 720p | 720p1080p1080p-plus4k |
image_urlStart frame — required for image-to-video. | string (URL) | 선택 사항 | — | public https URL, ≤ 30 MB |
end_image_urlOptional end frame. | string (URL) | 선택 사항 | — | public https URL, ≤ 30 MB |
media_urlsRequired for media-to-video. Images are limited to 30 MB; video URLs must support duration probing. | string[] (URL) | 선택 사항 | — | ≤ 12 public https image/video URLs |
generate_audioGenerate an audio track. | boolean | 선택 사항 | true | truefalse |
fixed_lensLock the camera lens. | boolean | 선택 사항 | false | truefalse |
seedOptional deterministic seed. | integer | 선택 사항 | — | -1 – 4294967295 |
Seedance prompt guide
Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.
- Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
- Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
- For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
- For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.
요청
curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
-H "Authorization: Bearer $SEEDANCE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-video-001" \
-d '{
"mode": "text-to-video",
"quality_tier": "standard",
"prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
"aspect_ratio": "16:9",
"duration": "5",
"resolution": "720p"
}'응답202
{
"id": "sd2_xxxxx",
"status": "processing",
"model": "seedance2",
"quality_tier": "standard",
"channel": "standard",
"credits_used": 30
}이 예시에 표시된 credits_used 값은 참고용입니다. 실제 사용량은 제출 시 계산되어 API 응답으로 반환됩니다.
작업 상태 확인
/api/v1/tasks/{id}요청
curl https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
-H "Authorization: Bearer $SEEDANCE_API_KEY"응답200
{
"id": "sd2_xxxxx",
"status": "completed",
"model": "seedance2",
"quality_tier": "standard",
"channel": "standard",
"resolution": "720p",
"credits_used": 30,
"credits_refunded": 0,
"output": {
"video_url": "https://...",
"last_frame_url": "https://...",
"seed": 123
},
"error": null,
"created_at": "2026-06-03T10:00:00.000Z",
"updated_at": "2026-06-03T10:03:12.000Z"
}status: processing · completed · failed
오류 코드
All errors share this shape:
{ "error": { "code": "invalid_request", "message": "Invalid request body" } }| 코드 | HTTP | 의미 |
|---|---|---|
unauthorized | 401 | Missing, invalid, or revoked API key. |
invalid_request | 400 | Bad input or unsupported field. |
purchase_required | 403 | Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it. |
insufficient_credits | 402 | Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied. |
rate_limited | 429 | Too many requests — the general limit is 30 requests per 60 seconds per account; Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. Retry after the Retry-After response header (in seconds). |
idempotency_conflict | 409 | Same Idempotency-Key reused with a different body, or still running. |
service_busy | 503 | Temporary upstream or credit-concurrency issue. Retry. |
not_found | 404 | Task does not exist or does not belong to this key owner. |
internal_error | 500 | Unexpected server-side failure. |
Claude Code와 함께 사용하기
Copy for AI를 사용해 전체 API를 깔끔한 Markdown으로 내보낸 뒤, Claude Code나 Codex에 붙여넣고 에이전트가 연동을 처리하도록 하세요. 또는 에이전트를 raw 텍스트 엔드포인트에 직접 연결하는 방법도 있습니다.
Skill
Claude Code, Codex, 또는 모든 에이전트에 Seedance 스킬을 설치하세요 — 시네마틱 프롬프트를 작성하고 API를 통해 렌더링까지 처리해 드립니다.
# Download the one-file skill from Seedance 2 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md자주 묻는 질문
API를 사용할 수 있는 사람은 누구인가요?
크레딧만 있다면 누구나 사용할 수 있습니다. 플랜 제한 없이 크레딧이 있는 모든 계정에서 API 키를 생성하고 호출할 수 있습니다.
크레딧은 어떻게 받나요?
요금제 페이지에서 충전하거나 구독하세요. 크레딧이 즉시 잔액에 추가됩니다.
웹사이트와 API 간에 크레딧이 공유되나요?
네 — 개인 크레딧 잔액은 웹 생성과 API 호출 모두에 사용됩니다. 팀의 경우, API 호출은 공유된 팀 풀이 아닌 각 멤버의 개인 잔액에서 차감됩니다.
어떻게 시작하나요?
대시보드에서 API 키를 생성한 후, Bearer 토큰을 사용하여 엔드포인트를 호출하세요. (위의 Quickstart를 참조하세요.)
호출이 insufficient_credits를 반환하면 어떻게 되나요?
잔액이 부족합니다 — 가격 페이지에서 충전하고 다시 시도해 주세요.