텍스트·이미지·참조 이미지로 4·6·8초 고품질 영상을 만드는 Veo 3.1 기반 생성 API
영상 작업은 접수한 뒤 상태를 조회하고, 완료되면 MP4 파일을 내려받는 흐름입니다. 취소 API는 제공하지 않으며, 실패하거나 처리 시간이 초과되면 예약된 포인트가 자동으로 전액 환불됩니다.
job_id<job_id>.mp4/rest/veo/jobstext 모드는 CL_AUTH_KEY와 JSON 본문을, image·reference 모드는 첨부 파일이 있으므로 multipart/form-data를 사용합니다.duration × 초당 포인트가 예약 차감됩니다. 완료 시 확정되고, 실패·시간 초과 시 전액 환불됩니다.job_id, waiting 상태, 모델 정보와 예약 포인트를 반환합니다.text | image | reference, 기본 textstandard | fast, 기본 standard4·6·8 중 하나만 허용, 기본 8. reference 모드와 resolution이 1080p·4k일 때는 8로 고정해야 합니다16:9 | 9:16, 기본 16:9. reference 모드에서는 지정해도 무시됩니다720p | 1080p | 4k, 기본 720p. 모든 모드에서 사용 가능하나 1080p·4k는 duration=8이 필요합니다true(정책 검수에서 오디오가 거부되면 작업이 실패하고 환불됩니다)_·-, 8~128자cfg_scale은 Veo에서 지원하지 않으며 전달하면 APICK_VIDEO_OPTION_NOT_SUPPORTED로 거절됩니다.
이미지는 PNG·JPEG·WebP, 128~8,192px, 종횡비 0.25~4, 50MB 이하만 허용합니다. Veo는 참조 영상 첨부를 지원하지 않습니다.
curl -X POST "https://apick.app/rest/veo/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"안개 낀 새벽 숲을 가로지르는 드론 샷, 시네마틱 조명","duration":8,"resolution":"1080p"}'curl -X POST "https://apick.app/rest/veo/jobs" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "mode=image" \
-F "image=@first_frame.jpg" \
-F "prompt=카메라가 서서히 줌아웃되며 전경이 드러나는 장면" \
-F "duration=6"{
"data": {
"job_id": "a1b2c3d4e5f647a8b9c0d1e2f3a4b5c6",
"status": "waiting",
"model": "veo",
"mode": "text",
"tier": "standard",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1080p",
"audio": true,
"point_per_second": 900,
"charged_point": 7200
},
"api": { "success": true, "cost": 7200 }
}/rest/veo/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/veo/jobs/$JOB_ID" \
-H "CL_AUTH_KEY: $API_KEY"{
"data": {
"job_id": "a1b2c3d4e5f647a8b9c0d1e2f3a4b5c6",
"status": "completed",
"model": "veo",
"mode": "text",
"tier": "standard",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1080p",
"audio": true,
"point_per_second": 900,
"charged_point": 7200,
"result_available": true,
"result_expires_at": "2026-09-20T12:00:00.000Z"
},
"api": { "success": true, "cost": 0 }
}{
"data": {
"job_id": "a1b2c3d4e5f647a8b9c0d1e2f3a4b5c6",
"status": "failed",
"result_available": false,
"result_expires_at": null,
"error": { "code": "APICK_VIDEO_GENERATION_FAILED", "message": "영상 생성에 실패했습니다. 포인트는 환불되었습니다." }
},
"api": { "success": true, "cost": 0 }
}/rest/veo/jobs/{job_id}/resultresult_available이 true일 때 호출합니다. Range 헤더로 구간 다운로드를 지원합니다(HTTP 206).video/mp4 파일을 반환합니다. 완료 후 7일 동안 반복 다운로드할 수 있습니다.<job_id>.mp4 파일이며 Content-Disposition으로 파일명을 안내합니다.curl -sS "https://apick.app/rest/veo/jobs/$JOB_ID/result" \
-H "CL_AUTH_KEY: $API_KEY" \
-o "$JOB_ID.mp4"접수 시 duration × 초당 포인트가 예약 차감됩니다. 완료되면 그대로 확정되고, 실패하거나 처리 시간이 초과되면 예약된 포인트가 전액 환불됩니다. 접수 후에는 취소할 수 없습니다.
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 도구로도 동일하게 사용할 수 있습니다. veo_jobs_create로 작업을 접수하고 veo_jobs_status로 상태를 조회합니다. 영상 파일은 MCP 응답 크기 제한 때문에 도구로 직접 전달하지 않으며, 상태 조회 응답의 result_url로 REST 다운로드 경로를 안내합니다. 자세한 내용은 MCP 연동 가이드와 /mcp/ai를 확인하세요.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.