API 빠른 시작
이미지-동영상 생성을 만들고 폴링합니다.
1. 자격 증명 설정
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Key는 서버 측 Secret Manager 또는 n8n Credential에만 저장하세요.
2. 생성 요청
입력 호스트는 API Key 허용 목록에 미리 등록되어야 합니다.
curl --request POST "$SEEDANCE_BASE_URL/videos" \
--header "Authorization: Bearer $SEEDANCE_API_KEY" \
--header "Idempotency-Key: order-10086-shot-1" \
--header "Content-Type: application/json" \
--data '{
"model":"seedance-2.0-pro","mode":"image-to-video",
"prompt":"피사체가 천천히 카메라를 향하고 배경은 안정적으로 유지됩니다.",
"inputs":[{"type":"image","url":"https://media.example.com/reference.png"}],
"parameters":{"duration_seconds":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}
}'API는 202, 생성 id, status_url, 실제 billing.cost_credits를 반환합니다. 과금은 PC와 동일합니다.
3. 같은 작업 폴링
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"상태가 queued 또는 processing이면 retry_after_seconds나 Retry-After를 따릅니다. 완료 후 output.video_url 또는 output.image_urls를 사용합니다.
생성 요청이 시간 초과되면 완전히 동일한 본문과 Idempotency-Key로 재시도하세요. 새 Key로 대체 작업을 자동 생성하지 마세요.
수락된 생성 요청은 202 Accepted를 반환합니다. 완료 응답은 다음 스키마와 same_as_pc 정책을 유지합니다.
{
"status": "completed",
"output": {
"urls": ["https://.../completed-video.mp4"],
"video_url": "https://.../completed-video.mp4"
},
"billing": {
"unit": "credits",
"cost_credits": 355,
"policy": "same_as_pc"
}
}첫 번째 동영상은 output.video_url에서 읽습니다.