跳转到内容
主站 新闻 控制台

视频生成(异步)

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

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)

Grok 原生 API 与本站的 OpenAI 兼容入口使用不同的传输格式。本站统一从 POST /v1/videos 提交任务,用户无需直接访问 xAI。

本地图片按 OpenAI Videos API 使用 input_reference 上传:

Terminal window
curl https://api.4allapi.com/v1/videos \
-H "Authorization: Bearer $AIPROXY_KEY" \
-F "model=grok-imagine-video-1.5" \
-F "prompt=女孩在暖色书吧中寻找一本书,电影 MV 镜头" \
-F "duration=15" \
-F "resolution=480p" \
-F "input_reference=@girl.png;type=image/png"

使用 -F 时不要手写 Content-Type;curl 会自动生成正确的 multipart/form-data; boundary=...。请求只需手动添加:

Authorization: Bearer YOUR_API_KEY
Terminal window
curl https://api.4allapi.com/v1/videos \
-H "Authorization: Bearer $AIPROXY_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5",
"prompt": "让瀑布奔流,镜头缓慢拉远",
"duration": 12,
"resolution": "720p",
"image": {"url": "https://example.com/waterfall.png"}
}'

image.url 支持公网 HTTPS URL 或 data:image/png;base64,...。本站也接受 OpenAI 兼容对象 input_reference.image_url,并在内部转换成 xAI 要求的 image.url。不要发送“JSON 请求体 + multipart 请求头”;两者不匹配会导致 上游拒绝媒体类型。

内部转换后的 xAI 原生请求头是:

Authorization: Bearer XAI_API_KEY
Content-Type: application/json

原生请求提交到 /v1/videos/generations,首帧结构为 "image":{"url":"..."};多张非首帧参考图使用 reference_images。 格式依据:xAI Image-to-Video、 xAI Reference-to-Video; 本站 multipart 字段遵循 OpenAI Videos API。

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 状态会附带失败原因,内容违规类失败请调整提示词后重新提交;
  • 视频链接有效期有限,生成成功后请尽快转存到自己的存储。