공개 API

자체 도구로 비디오 및 이미지 생성

키를 생성하고, Bearer 인증으로 API를 호출한 후, 결과가 준비될 때까지 작업 상태를 폴링하세요. Claude Code, Codex, 및 모든 HTTP 클라이언트에서 사용할 수 있어요.

키 관리

빠른 시작

1단계

키 생성

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

2단계

API 호출

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

3단계

결과 확인

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

인증

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

http

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

Seedance Video

텍스트, 이미지, 또는 미디어를 영상으로

POST

/api/v1/video/seedance

파라미터

매개변수	유형	필수	기본	허용 값
`mode` Generation mode.	`string`	선택 사항	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	선택 사항	`standard`	`standardpro`
`channel` Rendering channel.	`string`	선택 사항	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	필수	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	선택 사항	`16:9`	`1:121:94:33:416:99:16`
`duration` Clip duration.	`string`	선택 사항	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	선택 사항	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	선택 사항	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	선택 사항	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	선택 사항	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	선택 사항	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	선택 사항	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	선택 사항	`—`	`-1 – 4294967295`

작업 제출

bash

curl -X POST https://seedance2ai.io/api/v1/video/seedance \
  -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"
  }'

GPT Image 2

고충실도 이미지 생성

POST

/api/v1/image/gpt-image-2

파라미터

매개변수	유형	필수	기본	허용 값
`type` Generation type.	`string`	필수	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	선택 사항	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	필수	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	필수	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	필수	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	선택 사항	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	선택 사항	`—`	`1–10 public https URLs`

작업 제출

bash

curl -X POST https://seedance2ai.io/api/v1/image/gpt-image-2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-gpt-image-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "Editorial product photo of a transparent running shoe on chrome",
    "resolution": "1K",
    "aspectRatio": "1:1"
  }'

Nano Banana Pro

세련된 프리미엄 이미지 출력.

POST

/api/v1/image/nano-banana-pro

파라미터

매개변수	유형	필수	기본	허용 값
`type` Generation type.	`string`	필수	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	필수	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	선택 사항	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	선택 사항	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	선택 사항	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	선택 사항	`—`	`1–8 public https URLs`

작업 제출

bash

curl -X POST https://seedance2ai.io/api/v1/image/nano-banana-pro \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-nbp-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "A premium packaging mockup for an AI video studio",
    "image_size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

작업 상태 확인

상태가 완료되거나 실패할 때까지 폴링합니다.

bash

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

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance",
  "output": { "video_url": "https://..." },
  "credits_used": 30
}

오류 코드

코드	HTTP	의미
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`insufficient_credits`	`402`	Not enough credits on the balance.
`rate_limited`	`429`	Too many requests for this account.
`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.

Skill

Claude Code, Codex, 또는 모든 에이전트에 Seedance 스킬을 설치하세요 — 시네마틱 프롬프트를 작성하고 API를 통해 렌더링까지 처리해 드립니다.

bash

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

GitHub에서 보기

Claude Code와 함께 사용하기

AI용 복사 버튼을 눌러 전체 API를 깔끔한 마크다운으로 가져오세요. 그다음 Claude Code나 Codex에 붙여넣고 AI가 통합을 연결하게 하세요. 또는 에이전트를 원시 텍스트 엔드포인트에 바로 지정하세요.

llms.txt 열기

자주 묻는 질문

API를 사용할 수 있는 사람은 누구인가요?

크레딧만 있다면 누구나 사용할 수 있습니다. 플랜 제한 없이 크레딧이 있는 모든 계정에서 API 키를 생성하고 호출할 수 있습니다.

크레딧은 어떻게 받나요?

요금제 페이지에서 충전하거나 구독하세요. 크레딧이 즉시 잔액에 추가됩니다.

웹사이트와 API 간에 크레딧이 공유되나요?

네 — 개인 크레딧 잔액은 웹 생성과 API 호출 모두에 사용됩니다. 팀의 경우, API 호출은 공유된 팀 풀이 아닌 각 멤버의 개인 잔액에서 차감됩니다.

어떻게 시작하나요?

대시보드에서 API 키를 생성한 후, Bearer 토큰을 사용하여 엔드포인트를 호출하세요. (위의 Quickstart를 참조하세요.)

호출이 insufficient_credits를 반환하면 어떻게 되나요?

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