跳转到内容
4ALL API 文档
主站 新闻 控制台

视频生成(异步)

视频生成耗时较长(数十秒到数分钟),4ALL API 采用提交 + 轮询的异步协议: 先提交任务拿到 task_id,再轮询查询结果。

1. 提交任务

POST https://api.4allapi.com/v1/video/generations
Terminal window
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}
Terminal window
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 状态会附带失败原因,内容违规类失败请调整提示词后重新提交;
  • 视频链接有效期有限,生成成功后请尽快转存到自己的存储。