비디오 생성(비동기)

비디오 생성은 시간이 오래 걸리므로(수십 초에서 수 분), 4ALL API는 제출 + 폴링 비동기 프로토콜을 사용합니다: 먼저 작업을 제출하여 task_id를 받은 후, 폴링으로 결과를 조회합니다.

1. 작업 제출

POST https://api.4allapi.com/v1/video/generations

curl https://api.4allapi.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "无人机视角掠过清晨的海岸线,电影感,自然光",
    "size": "1280x720",
    "seconds": "8"
  }'

응답:

{ "task_id": "video-task-xxx", "status": "submitted" }

파라미터	설명
`model`	비디오 모델, 예: `veo-3.1`, `sora-2`, `kling-v3`, `omni-flash` 비디오 모델명
`prompt`	화면 및 카메라 움직임 설명
`size`	해상도(가로/세로), 모델 지원 범위에 따름
`seconds`	길이(초), 모델 지원 범위에 따름
`image`	이미지-비디오 변환 시 첫 프레임 참조 이미지(지원 모델, URL 또는 base64)

2. 결과 조회

GET https://api.4allapi.com/v1/video/generations/{task_id}

curl https://api.4allapi.com/v1/video/generations/video-task-xxx \
  -H "Authorization: Bearer $AIPROXY_KEY"

status는 submitted → processing → succeeded / failed 순서로 변경됩니다; 성공 시 비디오 다운로드 주소가 반환됩니다:

{
  "task_id": "video-task-xxx",
  "status": "succeeded",
  "video_url": "https://.../result.mp4"
}

폴링 권장 사항

5~10초 간격으로 폴링하며, 전체 타임아웃은 모델 생성 시간에 맞게 여유 있게 설정하세요(예: 10분);
failed 상태에는 실패 원인이 함께 반환되며, 콘텐츠 위반으로 인한 실패의 경우 프롬프트를 수정한 후 다시 제출하세요;
비디오 링크의 유효 기간은 제한되어 있으므로, 생성 성공 후 가능한 빨리 자신의 스토리지에 저장하세요.