텍스트·이미지·참조 소재로 최대 30초 영상을 만드는 Seedance 2.5 기반 생성 API
영상 작업은 접수한 뒤 상태를 조회하고, 완료되면 MP4 파일을 내려받는 흐름입니다. 취소 API는 제공하지 않으며, 실패하거나 처리 시간이 초과되면 예약된 포인트가 자동으로 전액 환불됩니다.
job_id<job_id>.mp4/rest/seedance/jobstext 모드는 CL_AUTH_KEY와 JSON 본문을, image·reference 모드는 첨부 파일이 있으므로 multipart/form-data를 사용합니다.duration × 초당 포인트가 예약 차감됩니다. 완료 시 확정되고, 실패·시간 초과 시 전액 환불됩니다.job_id, waiting 상태, 모델 정보와 예약 포인트를 반환합니다.reference 모드에서 참조 파일을 1개 이상 첨부하면 생략 가능text | image | reference, 기본 text16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive 중 하나, 기본 16:9. image 모드에서는 값을 지정해도 항상 adaptive로 처리됩니다(오류 아님)480p | 720p | 1080p, 기본 720p. 모든 모드에서 사용 가능하며 해상도별로 초당 포인트가 다릅니다(아래 요금 참고, 높은 해상도일수록 비용이 커집니다)true(정책 검수에서 오디오가 거부되면 작업이 실패하고 환불됩니다)_·-, 8~128자tier, negative_prompt, seed, cfg_scale는 Seedance에서 지원하지 않으며 전달하면 APICK_VIDEO_OPTION_NOT_SUPPORTED로 거절됩니다.
이미지는 PNG·JPEG·WebP·BMP·TIFF·GIF, 300~6,000px, 종횡비 0.4~2.5, 30MB 이하만 허용합니다. 참조 영상은 MP4·MOV·WebM, 50MB 이하만 허용합니다. reference 모드에서 참조 파일을 하나도 첨부하지 않으면 prompt가 필수입니다.
curl -X POST "https://apick.app/rest/seedance/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"해 질 녘 해안 도로를 달리는 오픈카, 부드러운 카메라 팬","duration":5,"aspect_ratio":"16:9"}'curl -X POST "https://apick.app/rest/seedance/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "mode=image" \
-F "image=@first_frame.png" \
-F "prompt=인물이 천천히 뒤돌아보며 미소짓는 장면" \
-F "duration=5"curl -X POST "https://apick.app/rest/seedance/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"해 질 녘 해안 도로를 달리는 오픈카, 부드러운 카메라 팬","duration":5,"resolution":"1080p"}'{
"data": {
"job_id": "7f7e43f578cd459db04696416435c789",
"status": "waiting",
"model": "seedance",
"mode": "text",
"tier": "standard",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"audio": true,
"point_per_second": 1250,
"charged_point": 6250
},
"api": { "success": true, "cost": 6250 }
}/rest/seedance/jobs/{job_id}job_id를 URL에 넣고 CL_AUTH_KEY를 전송합니다. 완료 전에는 5초 간격 조회를 권장합니다.waiting, processing, completed, failed 중 하나를 반환합니다.result_available과 result_expires_at으로 다운로드 가능 여부와 만료 시각을 확인합니다.curl -sS "https://apick.app/rest/seedance/jobs/$JOB_ID" \
-H "CL_AUTH_KEY: $API_KEY"{
"data": {
"job_id": "7f7e43f578cd459db04696416435c789",
"status": "completed",
"model": "seedance",
"mode": "text",
"tier": "standard",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"audio": true,
"point_per_second": 1250,
"charged_point": 6250,
"result_available": true,
"result_expires_at": "2026-09-20T12:00:00.000Z"
},
"api": { "success": true, "cost": 0 }
}{
"data": {
"job_id": "7f7e43f578cd459db04696416435c789",
"status": "failed",
"result_available": false,
"result_expires_at": null,
"error": { "code": "APICK_VIDEO_GENERATION_FAILED", "message": "영상 생성에 실패했습니다. 포인트는 환불되었습니다." }
},
"api": { "success": true, "cost": 0 }
}/rest/seedance/jobs/{job_id}/resultresult_available이 true일 때 호출합니다. Range 헤더로 구간 다운로드를 지원합니다(HTTP 206).video/mp4 파일을 반환합니다. 완료 후 7일 동안 반복 다운로드할 수 있습니다.<job_id>.mp4 파일이며 Content-Disposition으로 파일명을 안내합니다.curl -sS "https://apick.app/rest/seedance/jobs/$JOB_ID/result" \
-H "CL_AUTH_KEY: $API_KEY" \
-o "$JOB_ID.mp4"접수 시 duration × 초당 포인트가 예약 차감됩니다(resolution에 따라 초당 단가가 다릅니다). 완료되면 그대로 확정되고, 실패하거나 처리 시간이 초과되면 예약된 포인트가 전액 환불됩니다. 접수 후에는 취소할 수 없습니다.
APICK_VIDEO_AUTH_FAILEDAPICK_VIDEO_PAYMENT_REQUIREDAPICK_VIDEO_POINTS_INSUFFICIENTAPICK_VIDEO_INVALID_REQUESTAPICK_VIDEO_PROMPT_REQUIREDAPICK_VIDEO_MODE_NOT_SUPPORTEDAPICK_VIDEO_DURATION_INVALIDAPICK_VIDEO_SOURCE_REQUIREDAPICK_VIDEO_SOURCE_INVALIDAPICK_VIDEO_TOO_MANY_ACTIVE_JOBSAPICK_VIDEO_CONTENT_REJECTEDAPICK_VIDEO_RATE_LIMITEDAPICK_VIDEO_TEMPORARILY_UNAVAILABLEAPICK_VIDEO_TIMEOUTAPICK_VIDEO_GENERATION_FAILEDAPICK_VIDEO_JOB_NOT_FOUNDAPICK_VIDEO_JOB_CONFLICTAPICK_VIDEO_RESULT_EXPIREDMCP 도구로도 동일하게 사용할 수 있습니다. seedance_jobs_create로 작업을 접수하고 seedance_jobs_status로 상태를 조회합니다. 영상 파일은 MCP 응답 크기 제한 때문에 도구로 직접 전달하지 않으며, 상태 조회 응답의 result_url로 REST 다운로드 경로를 안내합니다. 자세한 내용은 MCP 연동 가이드와 /mcp/ai를 확인하세요.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.