Veo 3.1 Lite

模型 ID 为 veo-3.1-lite，支持文生视频和首帧 / 首尾帧生视频，时长 4、6 或 8 秒，只能输出横屏或竖屏的 720p / 1080p。

按次计费，每个成功的任务算 1 次，时长和分辨率不影响次数。单价和开放状态以模型广场和 API Key 权限为准，失败任务退回预扣额度。

接口

操作	方法与路径
创建任务	POST https://api.furry.vg/v1/videos
查询任务	GET https://api.furry.vg/v1/videos/{id}
下载视频	GET https://api.furry.vg/v1/videos/{id}/content

请求头为 Authorization: Bearer <S3AI_API_KEY>，请求体为 JSON。查询和下载要用创建任务的同一账户的 API Key。

请求参数

参数	类型	说明
model	string	veo-3.1-lite
prompt	string	必填，1–10000 字符
seconds	integer / 整数字符串	4、6 或 8，默认 8
duration	integer / 整数字符串	同 seconds，二选一
size	string	1280x720（默认）、720x1280、1920x1080、1080x1920
resolution	string	720p 或 1080p，不能和 size 同时用
aspect_ratio	string	16:9（默认）或 9:16，配合 resolution 使用
audio	boolean	是否生成音轨
n	integer	只能是 1
images	string[]	1 张为首帧，2 张为首帧和尾帧
start_frame	string	首帧，images 的另一种写法
end_frame	string	尾帧，需要同时有首帧

images 和 start_frame / end_frame 只能选一种写法。不支持普通参考图、参考视频和参考音频，audio 只控制输出是否带声音。表外的字段会被拒绝。

参考图片

images、start_frame、end_frame 可以填公网 URL 或 Data URL：

• URL：必须能直接用 HTTP(S) 下载，不能包含用户名密码，并且在任务完成前不能失效。
• Data URL：格式为 data:<MIME 类型>;base64,<数据>，例如 data:image/png;base64,iVBORw0KGgo...。不接受省略前缀的裸 Base64。

单张图片不超过 20 MB。不支持 multipart/form-data 文件上传。

frame="data:image/png;base64,$(base64 -w0 start.png)"

示例

文生视频

curl https://api.furry.vg/v1/videos \
  -H "Authorization: Bearer $S3AI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "veo-3.1-lite",
    "prompt": "清晨的海边，海浪轻轻拍打礁石，镜头缓慢推进",
    "seconds": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

首尾帧

{
  "model": "veo-3.1-lite",
  "prompt": "从首帧平滑过渡到尾帧",
  "seconds": 4,
  "images": [
    "https://example.com/start.png",
    "data:image/png;base64,iVBORw0KGgo..."
  ]
}

只要首帧时 images 里放一张图。用 start_frame / end_frame 写法时效果相同：

{
  "model": "veo-3.1-lite",
  "prompt": "从首帧平滑过渡到尾帧",
  "seconds": 4,
  "start_frame": "https://example.com/start.png",
  "end_frame": "https://example.com/end.png"
}

已知情况

截至 2026-10-22，文生视频已验证可用；首帧和首尾帧接口已开放，但还没有测试通过，暂不保证稳定。实际输出分辨率以生成文件为准。

查询与下载

curl "https://api.furry.vg/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $S3AI_API_KEY"

status 依次为 queued、in_progress，最后是 completed 或 failed。每 10–20 秒查一次就够了。完成后的响应：

{
  "id": "video_example",
  "object": "video",
  "model": "veo-3.1-lite",
  "status": "completed",
  "progress": 100,
  "url": "https://ai.furry.vg/v1/tasks/video_example/artifacts/video/content?access=...",
  "content_url": "https://ai.furry.vg/v1/tasks/video_example/artifacts/video/content?access=..."
}

url 和 content_url 是同一个带签名的下载链接，域名和签名以实际响应为准。这个链接不需要 API Key 就能 GET / HEAD，支持 Range，所以不要随意分享。链接没有固定过期时间，但文件不会一直保留，请尽快下载。

也可以用 API Key 下载：

curl "https://api.furry.vg/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $S3AI_API_KEY" \
  -o result.mp4

错误

参数错误会直接说明原因，例如时长不是 4 / 6 / 8、尺寸不支持、有尾帧没首帧。

创建阶段的服务端错误一律返回 HTTP 503：

{
  "code": "service_unavailable",
  "message": "service temporary unavailable",
  "data": null
}

已经拿到 id 的任务如果后来失败，查询接口返回 status: "failed"，原因在 error.message。

创建请求超时又没拿到 id 时，不要马上重试，以免生成重复任务。