API 文档模型文档

Kling 3.0 Turbo API

Kling 3.0 Turbo: fast high-motion video with native audio; 720p (standard) or 1080p (pro), 3–15 s.

POST/api/v1/generations需要 Bearer API Key
kling-3.0-turbo视频 · Kuaishou模型详情与价格

此模型使用的接口

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入,请将示例媒体地址替换为可访问的文件。

请求

cURL
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0-turbo",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

输入参数

JSON 请求体

调用 /generations 和 /quote 时,将以下参数放入 input;调用 /images/generations 时放在顶层;对话参数放在 /chat/completions 顶层。

model
string必填

模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。

可选值:"kling-3.0-turbo"
input
object必填

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

provider
string可选

可选供应商 slug。不传时自动路由;项目配置可能固定供应商。

project
string可选

可选项目 ID,使用该项目公开的模型目录和路由配置。

callback_url
string<uri>可选

公开 HTTPS 地址,最长 1,000 字符。接收最终任务对象,不允许内网地址。

input.prompt
string必填
input.image_url
string<uri>可选

Optional start image (image-to-video)

input.duration
integer可选
默认值:5
最小值:3
最大值:15
input.resolution
enum可选
默认值:"720p"
可选值:"720p""1080p"
input.aspect_ratio
enum可选
默认值:"16:9"
可选值:"16:9""9:16""1:1"

响应示例

200 · application/json
{
  "id": "gen_example",
  "object": "generation",
  "model": "kling-3.0-turbo",
  "type": "video",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

响应仅用于说明结构;ID、用量、价格和结果以实际请求为准。

输出字段

id
string

创建任务返回的生成 ID。

object
"generation"

generation

model
string

模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。

type
video | image | audio | chat
provider
string

可选供应商 slug。不传时自动路由;项目配置可能固定供应商。

status
string

queued(排队)/ processing(处理中)/ succeeded(成功)/ failed(失败)。成功或失败后停止轮询。

input
object

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

outputs
string[]

结果文件 URL 列表;结果未就绪时为空。链接可能过期,请及时下载。

error
string | null

失败时的错误信息,否则为 null。

credits
number

该任务扣除的积分,退款后为 0。

price_usd
number

该任务的美元价格,退款后为 0。

created_at
string

ISO 8601 格式的创建时间。

completed_at
string | null

ISO 8601 格式的完成时间,进行中为 null。

使用说明

  • 轮询间隔至少 3 秒。同步生图接口返回 504 时,任务可能仍在进行,应使用 error.id 查询,避免重复创建。

给 AI 使用

把文档索引或完整接口文档交给 AI 编程助手,包含实时模型参数。