Veo 视频概览

Veo 视频适合高质量文生视频、图生视频和参考素材视频。MoonApiX 将 Veo 场景整理到视频任务流程中，创建任务后通过任务 ID 查询最终结果。

当前模型

Veo 模型名以 MoonApiX 后台、模型列表接口和 API Reference 为准。接入前建议先调用 GET /v1/models 确认可用模型。

当前接口行为

项目	当前行为
创建任务	使用 POST /v1/videos。
查询任务	使用 GET /v1/tasks/{task_id} 或 GET /v1/videos/{task_id}。
输入方式	支持文本 prompt；图生视频场景可传图片 URL 或素材引用，具体字段以模型说明为准。
回调	可在创建任务时传 callback_url，任务完成后接收回调。

接口路径

方法	路径	用途
POST	/v1/videos	创建 Veo 视频任务。
GET	/v1/tasks/{task_id}	查询任务中心状态。
GET	/v1/videos/{task_id}	查询视频任务结果。

常用字段

字段	说明
model	Veo 模型名，以模型列表和 API Reference 为准。
prompt	视频描述，建议包含主体、动作、镜头、光照和风格。
duration / seconds	视频时长。
aspect_ratio / ratio	视频比例。
image / image_url	图生视频或参考图输入。
callback_url	任务完成后的回调地址。

请求示例

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-model",
    "prompt": "A product reveal video with smooth camera movement and natural studio lighting.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

任务处理

阶段	处理方式
提交成功	保存 id 或 task_id、模型名、prompt 和业务订单。
生成中	轮询查询接口，或等待 callback_url 回调。
完成	读取视频 URL，并保存完整查询结果。
失败	保存错误信息和原始请求体，便于用户重试。

相关页面

• 视频模型矩阵
• 创建视频任务
• 查询视频任务
• Veo 指南