자체 도구로 영상 및 이미지 생성

빠른 시작

1. 1

   키 생성

   대시보드에서 API 키를 생성하세요. 키는 한 번만 표시되므로, 안전한 곳에 보관하세요.

   키 관리
2. 2

   API 호출

   Bearer 키와 Idempotency-Key 헤더를 포함하여 POST 요청을 전송하세요.

   cURLJavaScriptPython

   Copy

   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"
     }'

3. 3

   결과 확인

   작업 상태 엔드포인트를 폴링하여 상태가 완료 또는 실패가 될 때까지 확인한 후, 출력을 읽습니다.

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

인증

모든 요청은 Authorization 헤더에 Bearer API 키를 포함하여 인증됩니다.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://www.seedance2ai.io/api/v1/balance" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

curl "https://www.seedance2ai.io/api/v1/models" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

오류 코드

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

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.0 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를 반환하면 어떻게 되나요?

잔액이 부족합니다 — 가격 페이지에서 충전하고 다시 시도해 주세요.