视频生成(异步)
视频生成耗时较长(数十秒到数分钟),4All API 采用提交 + 轮询的异步协议:
先提交任务拿到 task_id,再轮询查询结果。
1. 提交任务
Section titled “1. 提交任务”POST https://api.4allapi.com/v1/video/generationscurl 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 Imagine Video 1.5
Section titled “Grok Imagine Video 1.5”Grok 原生 API 与本站的 OpenAI 兼容入口使用不同的传输格式。本站统一从
POST /v1/videos 提交任务,用户无需直接访问 xAI。
本地参考图:multipart
Section titled “本地参考图:multipart”本地图片按 OpenAI Videos API 使用 input_reference 上传:
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公网 URL 或 Base64:JSON
Section titled “公网 URL 或 Base64:JSON”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_KEYContent-Type: application/json原生请求提交到 /v1/videos/generations,首帧结构为
"image":{"url":"..."};多张非首帧参考图使用 reference_images。
格式依据:xAI Image-to-Video、
xAI Reference-to-Video;
本站 multipart 字段遵循 OpenAI Videos API。
2. 查询结果
Section titled “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状态会附带失败原因,内容违规类失败请调整提示词后重新提交;- 视频链接有效期有限,生成成功后请尽快转存到自己的存储。