www.seedance2.ink 에서 제공하는 REST 엔드포인트로 Seedance 2.0, Seedance 2.0 Fast, Seedance 1.5 Pro를 연동할 수 있습니다. API는 비동기 작업 모델을 따르며 순수 텍스트 프롬프트와 이미지 기반 요청을 모두 지원합니다.
대시보드에서 API 키를 만든 뒤 https://www.seedance2.ink/api/open/v1 로 요청을 보내고, polling 또는 webhook으로 결과를 받을 수 있습니다.
1. API 키로 인증하기
브라우저 세션 대신 Seedance 계정에서 발급된 Bearer token을 사용합니다.
2. 생성 작업 제출하기
프롬프트와 미디어 payload를 한 번 보내면 즉시 request id를 돌려받습니다.
3. 상태를 추적하고 결과 받기
작업이 비동기 생성 라이프사이클을 거치는 동안 polling 또는 callback으로 진행 상황을 받을 수 있습니다.
공개 API는 이미 웹 애플리케이션을 구동하는 동일한 생성 체인을 기반으로 하며, 이를 안정적인 개발자용 엔드포인트로 노출합니다.
요금은 생성된 영상의 초 단위로 계산되며 모델과 해상도에 따라 달라집니다.
| 모델 | 480p | 720p | 1080p |
|---|---|---|---|
| Seedance 2.0 | $0.050/s | $0.100/s | $0.200/s |
| Seedance 2.0 Fast | $0.040/s | $0.080/s | $0.160/s |
| Seedance 1.5 Pro | $0.020/s | $0.040/s | $0.080/s |
예: Seedance 2.0 으로 720p 5초 영상을 생성하면 $0.50 이고, 크레딧 기준으로는 40 크레딧입니다.
curl -X POST https://www.seedance2.ink/api/open/v1/video/generations \
-H "Authorization: Bearer sd2_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "A neon-lit alley in heavy rain, cinematic tracking shot",
"mediaUrls": [
"https://example.com/reference/start-frame.jpg"
],
"aspectRatio": "16:9",
"duration": 5,
"resolution": "720p",
"webhookUrl": "https://your-app.com/webhooks/seedance",
"metadata": {
"orderId": "demo_1001"
}
}'curl https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890 \
-H "Authorization: Bearer sd2_live_your_api_key"
{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"model": "seedance-2.0",
"prompt": "A neon-lit alley in heavy rain, cinematic tracking shot",
"duration": 5,
"aspectRatio": "16:9",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}모든 생성 요청은 예측 가능한 상태 전이를 갖는 비동기 작업으로 처리됩니다.
queued: 요청이 정상 접수되었고 업스트림 처리 대기 중입니다.
processing: 모델 작업이 실행 중이며 최종 영상은 아직 준비되지 않았습니다.
succeeded / failed / cancelled: 작업이 종료되었고 최종 결과 또는 오류 payload 를 조회할 수 있습니다.
로컬 개발에서는 polling 이 가장 간단하고, 애플리케이션 서버에서 자동 수신하려면 webhookUrl 을 설정하세요.
현재 API 표면은 의도적으로 단순합니다. 생성 엔드포인트, 상태 엔드포인트, 모델 조회 엔드포인트로 시작합니다.