跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
VEO 3.1 接口规格

BASE_URL = https://api.apiyi.com,所有请求带 Authorization: Bearer <你的 API key>。

​
鉴权

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
模型

模型时长(秒)分辨率画面比备注
veo-3.1-fast-generate-preview4 / 6 / 8720p / 1080p / 4k16:9 / 9:161080p、4k 仅支持 8s
veo-3.1-generate-preview4 / 6 / 8720p / 1080p / 4k16:9 / 9:16同上
价格(按模型名,按次计费,时长 / 分辨率不影响单价):
模型单价
veo-3.1-fast-generate-preview$0.3 / 次
veo-3.1-generate-preview$1.2 / 次
异步调用,只对成功任务计费。失败 / 取消不扣费。

​
接口

​
1. 创建任务(文生视频)

POST /v1/videos
Content-Type: application/json
body: 
{
  "model": "veo-3.1-fast-generate-preview",
  "prompt": "黄昏海边的灯塔,镜头缓慢推进,海浪轻拍礁石,电影级光影,稳定运镜",
  "duration": 8,
  "size": "1280x720",
  "metadata": {
    "negativePrompt": "blurry, watermark, distorted, low quality",
    "resolution": "720p",
    "aspectRatio": "16:9",
    "seed": 20260521
  }
}
参数识别优先级:
  • 秒数:metadata.durationSeconds > duration > seconds > 8
  • 分辨率:metadata.resolution > size > 720p
  • 比例:显式 metadata.aspectRatio 或表单字段 > 由 size 推导 > 16:9
响应: 
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "...",
  "status": "queued",
  "progress": 0,
  "created_at": 1775025000
}

​
2. 创建任务(图生视频)

multipart/form-data,图片字段名固定 input_reference: 
POST /v1/videos
-F model=veo-3.1-fast-generate-preview
-F prompt=...
-F input_reference=@./first.png;type=image/png
-F seconds=8
-F size=1280x720
-F resolution=720p
-F aspectRatio=16:9
-F seed=20260521
只取第一张图;多参考图/首尾帧/视频扩展暂未开放。

​
3. 查询状态

GET /v1/videos/{task_id}
响应字段:status ∈ {queued, in_progress, completed, failed}、progress、completed_at(完成时)。 可选另一查询接口(直接拿下载 URL): 
GET /v1/video/generations/{task_id}
响应:data.status ∈ {queued, processing, succeeded, failed}、data.url(可下载)。

​
4. 下载结果

GET /v1/videos/{task_id}/content
直接返回 mp4 二进制(带 Authorization 头,跟 -L)。

​
关键约束/坑

  1. prompt 必填。
  2. 不要传 generateAudio 参数 → 上游会回 INVALID_ARGUMENT。
  3. 想控音频效果就写进 prompt。
  4. 1080p / 4k 时 duration 必须 = 8。
  5. 视频扩展(extend)只支持 720p,本站接口暂未开放。
  6. 图生视频:推荐传文件或 Base64,不能 URL。
  7. 异步任务,只有成功才计费。
  8. 默认时长 8s、默认分辨率 720p。