Veo 4 视频生成

能力与适用场景

• 模型 id: 以模型广场在售的视频生成模型为准（示例使用 your-video-model-id 占位）。
• 文生视频: 由文字描述直接生成动态画面。
• 图生视频: 提供参考图，以图为起点生成动态画面。
• 典型场景: 广告短片、产品演示、社媒内容、影视分镜预览。

调用流程

视频生成耗时远长于普通请求，接口采用异步任务模式:

1. 提交生成任务，立即返回任务 id。
2. 轮询任务状态，直到完成或失败。
3. 完成后通过返回的地址下载视频。

提交生成任务

POST https://api.yomiapi.com/v1/video/generations

请求参数

size 按最长边映射分辨率档位:1920 及以上为 1080p,3840 及以上为 4K,其余为 720p;高大于宽时输出 9:16 竖屏，否则为 16:9 横屏。

Python 示例

import requests

resp = requests.post(
    "https://api.yomiapi.com/v1/video/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "your-video-model-id",
        "prompt": "无人机镜头缓缓掠过黄昏的海岸线,海浪拍打礁石,电影质感",
        "size": "1280x720",
        "seconds": "8"
    }
)
task = resp.json()
print(task["id"], task["status"])

提交成功即返回任务对象:

{
  "id": "task_xxxxxxxx",
  "task_id": "task_xxxxxxxx",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1753600000
}

查询任务状态

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

轮询示例

import time
import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
task_id = "task_xxxxxxxx"  # 提交接口返回的 id

while True:
    r = requests.get(
        f"https://api.yomiapi.com/v1/video/generations/{task_id}",
        headers=headers
    )
    data = r.json()["data"]
    if data["status"] == "succeeded":
        print("视频地址:", data["url"])
        break
    if data["status"] == "failed":
        print("生成失败:", data.get("error"))
        break
    time.sleep(10)

下载与保存

任务完成后，查询响应中的 url 即为视频地址;也可直接调用内容接口下载(需携带 Authorization 头):

GET https://api.yomiapi.com/v1/videos/{task_id}/content

生成结果请及时下载保存，避免链接失效后无法获取。

OpenAI 兼容接口

平台同时提供 OpenAI Videos 风格的等价接口，便于按 OpenAI 视频接口规范集成:

• 提交: POST /v1/videos,参数与上文一致。
• 查询: GET /v1/videos/{task_id},返回视频对象，状态为 queued、processing、succeeded、failed。

计费与使用建议

• 计费: 视频生成的计费方式与单次费用以模型广场与「用量统计」实际扣费为准。
• 提示词: 描述镜头语言(推、拉、摇、移)、主体动作与场景光线，比堆砌形容词更有效;物理运动的还原效果取决于动作描述的具体程度。
• 轮询节奏: 生成通常需要数分钟，建议每 10 秒左右查询一次，避免高频请求。