비동기 작업과 웹훅
모든 생성 요청은 즉시 202와 작업 ID를 반환합니다. 작업을 폴링하거나, 상태가 바뀔 때마다 서명된 웹훅을 받으세요.
Seedance 2.0 API초 단위 요금
키 하나로 Seedance 2.0 Mini와 Fast를 모두 사용할 수 있습니다. 먼저 견적을 받고, 멱등성 키와 함께 제출하면, 작업이 끝났을 때 웹훅을 받습니다.
실제 생성은 아직 열리지 않았습니다
이메일을 남겨 주시면 열릴 때 한 번만 연락드리겠습니다.
개발자 API는 신청제입니다.
curl https://api.pershot.app/v1/videos/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-fast",
"prompt": "Perfume mist in hard side light. Slow push-in, black background, grain.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"max_credits": 34
}'{
"id": "job_01J9ZK4T8W",
"object": "job",
"kind": "video",
"status": "queued",
"money_status": "reserved",
"queue_position": 2,
"requested_model": "seedance-2.0-fast",
"credits_quoted": 34,
"credits_charged": null
}해상도별초 단위 요금
동영상 길이(초)를 기준으로 청구됩니다. 동영상을 읽는 작업은 입력 시간(초)도 더 낮은 요율로 청구됩니다.
| 모델 | 480p | 720p |
|---|---|---|
| Seedance 2.0 Mini텍스트 또는 이미지 입력 | $0.020/초$10당 약 500초 | $0.042/초$10당 약 238초 |
| Seedance 2.0 Mini동영상 입력 포함 | $0.012/초$10당 약 833초 | $0.025/초$10당 약 400초 |
| Seedance 2.0 Fast텍스트 또는 이미지 입력 | $0.031/초$10당 약 322초 | $0.067/초$10당 약 149초 |
| Seedance 2.0 Fast동영상 입력 포함 | $0.019/초$10당 약 526초 | $0.040/초$10당 약 250초 |
모든 호출에따라오는 것
모든 호출에 상한
quote_id 또는 max_credits 상한을 보내세요. 이 상한을 넘겨 청구하지 않으며, 상한이 없는 Auto 요청은 거부됩니다.
두 번 청구되지 않는 재시도
24시간 이내에 같은 Idempotency-Key를 보내면 같은 작업이 반환되므로, 시간 초과 후 재시도해도 안전합니다.
대사할 수 있는 사용량
일별, 키별, 모델별 사용량을 JSON 또는 CSV로 제공합니다. 가격은 키가 아니라 개발자 API 가격표를 따릅니다.
fal이나 Replicate에서옮겨 오시나요?
필드 이름은 가능한 한 일반적인 Seedance 입력을 따릅니다. 이용은 신청제이며, 자신의 작업을 자동화하기 위한 것입니다. 달라지는 점:
- 엔드포인트
- POST https://api.pershot.app/v1/videos/generations 요청을 보낸 뒤, 반환된 ID로 GET https://api.pershot.app/v1/jobs/job_… 요청을 보내 결과를 받으세요.
- 인증
- sk_test_ 또는 sk_live_로 시작하는 키를 사용한 Authorization: Bearer.
- 멱등성
- 모든 생성 요청에 Idempotency-Key 헤더.
- 가격 상한
- max_credits 상한 또는 POST /v1/quotes에서 받은 quote_id.
- 오디오
- generate_audio는 true 또는 false이며, 가격은 같습니다.
- 사용자 ID
- 승인된 개발자 계정용입니다(신청제). 선택 사항인 end_user_id로 요청에 내 사용자 ID를 붙이면 사용량에 표시됩니다.
Claude와 Codex에서도 사용할 수 있습니다
MCP로 로그인하면 스튜디오처럼 크리에이티브 잔액을 쓰고, 크레딧을 쓰기 전에 가격을 확인합니다. 이 잔액은 개발자 API 잔액과 별개입니다.
API질문
API 키에 비용이 드나요?
아니요. 키는 무료이며, 이용은 신청제입니다. 스튜디오에서 신청하세요. 각 호출은 개발자 API 잔액에서 결제되며, 이 잔액은 크리에이티브 잔액과 별개입니다.
호출 가격은 어떻게 매겨지나요?
청구 1초당 가격입니다. Fast 720p는 $0.067, Mini 480p는 $0.020입니다. 입력 동영상 시간(초)도 더 낮은 요율로 포함됩니다.
실패한 작업도 청구되나요?
아니요. 작업에서 동영상이 나오지 않았거나(실패 또는 콘텐츠 거부) 안전 검사가 결과를 막으면 보류된 크레딧이 환불되며, 작업에 사유가 표시됩니다. 동영상을 전달한 작업은 청구됩니다.
한도는 어떻게 되나요?
키당 분당 60회 요청입니다. 개발자 API 계정은 기본적으로 작업 3개를 동시에 실행하며, 요청에 따라 늘릴 수 있습니다. 멤버십 요금제는 크리에이티브 계정의 한도를 올릴 뿐 이 계정에는 적용되지 않으며, 키를 추가해도 처리 용량은 늘어나지 않습니다.
언제 사용할 수 있나요?
실제 Seedance 생성은 아직 열리지 않았습니다. 모델 페이지에 이메일을 남겨 주시면 열릴 때 한 번만 연락드리겠습니다.