S3AI Docs

Appearance

kling v3 / kling o3 / veo 3.1 lite 视频生成 ​

kling-v3、kling-o3 和 veo-3.1-lite 通过异步视频接口生成 MP4。请求使用 JSON，图片和视频参考通过可公开访问的 HTTP(S) URL 提交。

这三个模型按次计费：每个成功任务生成一条视频，计费数量为 1，时长和分辨率不额外乘算次数。具体单价和开放状态以模型广场及当前 API Key 权限为准。任务失败会退还预扣额度。

模型与参考输入 ​

模型文生视频普通参考图首帧 / 首尾帧参考视频时长
kling-o3支持reference_images，最多 7 张start_frame，可选 end_frameinput_video，可同时附最多 4 张普通参考图3–15 整数秒；参考视频模式不传时长
kling-v3支持不支持start_frame，可选 end_frame不支持3–15 整数秒
veo-3.1-lite支持不支持images，1 张为首帧，2 张为首尾帧不支持4、6 或 8 秒

kling-o3 的首尾帧模式不能与普通参考图或参考视频混用。任何模型使用 end_frame 时都必须同时提供 start_frame。veo-3.1-lite 也接受 start_frame / end_frame，网关会将其转换为 images，两种写法不能混用。

实测范围 ​

2026-10-22 的测试已确认：三个模型均成功生成纯文本视频；kling-o3 的两张普通参考图、首尾帧、参考视频、参考视频加图片均生成成功；kling-v3 的单首帧生成成功。

kling-v3 的首尾帧和 veo-3.1-lite 的图片输入已按接口约定接入，但本次测试未成功完成，暂不能承诺稳定可用。参考视频仅在 kling-o3 开放。没有开放参考音频输入，audio 只控制是否生成音轨。

参考素材影响生成结果，不保证逐帧复刻。参考视频模式的输出不保证与源视频等长；实测 3 秒素材生成约 5 秒视频。部分结果的实际分辨率与请求尺寸不同，应以 MP4 元数据为准。

接口 ​

用途方法与路径
创建任务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 <API_KEY>。创建成功后保存网关返回的 id，使用同一账户的 API Key 轮询该任务。不要猜测任务 ID。

参数 ​

参数类型说明
modelstring上表中的模型 ID
promptstring必填，1–10000 字符
secondsinteger 或整数字符串Kling 默认 5 秒，Lite 默认 8 秒；input_video 模式必须省略
durationinteger 或整数字符串seconds 的别名，二者只能使用一个
sizestring默认 1280x720，可用值见下表
resolutionstring720p、1080p、2160p（别名 4k）；不能与 size 混用
aspect_ratiostring默认 16:9，可选 1:1 或 9:16；与 resolution 配合，不能与 size 混用
audioboolean可选，生成音轨的开关
ninteger可选，仅允许 1
start_framestring首帧图片 URL
end_framestring尾帧图片 URL，必须同时提供首帧
reference_imagesstring[]仅 kling-o3 的普通参考图
imagesstring[]仅 Lite 的首帧或首尾帧
input_videostring仅 kling-o3 的一段参考视频 URL

只接受列出的字段。当前不支持 multipart 文件上传、Base64、data URI、参考音频或多个输出。素材 URL 不能包含用户名密码，且必须在任务处理期间保持可访问。

分辨率横屏 16:9方形 1:1竖屏 9:16
720p1280x720960x960720x1280
1080p1920x10801440x14401080x1920
2160p3840x21602880x28802160x3840

Lite 只接受 720p / 1080p 的横屏或竖屏；kling-o3 参考视频模式不接受 2160p。尺寸表是允许的请求参数，实际输出以生成文件为准，未对全部尺寸组合逐一实测。

请求示例 ​

以下 S3AI_API_KEY 为本站 API Key。示例素材域名仅为占位符，请替换为真实可访问的地址。

文生视频 ​

bash
curl https://api.furry.vg/v1/videos \
  -H "Authorization: Bearer $S3AI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-o3",
    "prompt": "一只小机器人在蓝色背景前缓慢挥手，固定镜头，自然运动",
    "seconds": 3,
    "size": "1280x720"
  }'

将模型替换为 kling-v3 时仍可使用上述时长。Lite 请改为 veo-3.1-lite，时长使用 4、6 或 8。

普通参考图 ​

json
{
  "model": "kling-o3",
  "prompt": "保持参考图片中机器人的外形，让它转身并向前走",
  "seconds": 3,
  "reference_images": ["https://example.com/robot.png"],
  "size": "1280x720"
}

首尾帧 ​

json
{
  "model": "kling-o3",
  "prompt": "从首帧自然过渡到尾帧，固定镜头",
  "seconds": 3,
  "start_frame": "https://example.com/start.png",
  "end_frame": "https://example.com/end.png"
}

kling-v3 使用同样字段；仅首帧时省略 end_frame。Lite 使用下面的格式，或使用同义的 start_frame / end_frame：

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

参考视频与参考图片 ​

json
{
  "model": "kling-o3",
  "prompt": "参考视频中的运动，保持图片中的机器人外形",
  "input_video": "https://example.com/reference.mp4",
  "reference_images": ["https://example.com/robot.png"],
  "size": "1280x720"
}

此模式省略 seconds / duration；不需要图片时省略 reference_images。

轮询与下载 ​

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

status 可能为 queued、in_progress、completed 或 failed。建议每 10–20 秒查询一次。状态完成后，响应中的 url 和 content_url 指向同一个网关签名下载地址；这些地址不会直接暴露媒体存储地址。

json
{
  "id": "video_example",
  "object": "video",
  "model": "kling-o3",
  "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 与具体任务和产物绑定，可直接 GET / HEAD，并支持 Range 分段读取。链接本身没有固定到期时间，实际可下载时间取决于文件保留和服务策略；建议完成后及时保存。签名链接包含下载授权，请妥善保存。

也可使用本站 API Key 下载：

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

错误处理 ​

本地参数不合法会返回明确提示，例如时长越界、该模型不支持参考视频、尾帧缺少首帧。请修正参数后再提交。

服务在创建阶段失败时，错误消息统一为 service temporary unavailable，不返回内部账户、余额、供应商或网络详情。服务端故障返回 HTTP 503；明确拒绝请求的错误可能保留相应的 4xx 状态。创建失败响应的 message 位于顶层，例如：

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

已获得任务 ID 的任务若随后失败，查询接口仍返回任务对象，status 为 failed，固定错误文本位于 error.message，例如：

json
{
  "id": "video_example",
  "status": "failed",
  "error": {
    "code": "service_unavailable",
    "message": "service temporary unavailable"
  }
}

错误代码和 HTTP 状态随错误阶段变化，请结合 HTTP 状态和任务 status 处理失败。创建请求超时且未拿到任务 ID 时，不要立即重复提交，以免生成重复任务；已获得 ID 的任务继续使用该 ID 查询。

Powered by VitePress

Copyright © 2026 S3AI