Kling O3 Image 图像编辑

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kwaivgi/kling-image-o3/edit",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "resolution": "1K",
    "size": "16:9",
    "output_format": "png",
    "n": 1
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

使用 Kling O3 结合多张参考图和主体元素改造图像，输出最高 4K，支持视觉变体。

​

模型

• kwaivgi/kling-image-o3/edit - 使用提示词和参考图编辑图像。

​

功能

• 使用提示词和参考图编辑图像。
• image_urls 接受 1-10 张图像。
• 可选 1K、2K、4K 输出分辨率。
• 通过 elements 提供额外的主体参考。
• 通过 n 控制输出图像数量。

​

输出选项

​

图像尺寸

• size：可选。可选值：auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9。默认：16:9。

​

分辨率

• resolution：可选。可选值：1K、2K、4K。默认：1K。

​

图像数量

• n：可选。要生成的图像数量。1 到 9 的整数。默认：1。小数、字符串和布尔值会被拒绝。

​

输出格式

• output_format：可选。可选值：jpeg、png、webp。默认：png。

​

高级参数

只有省略可选 input 字段时才使用默认值。显式传入 null 或空字符串会被拒绝。可以传入空的 elements 数组。 model 和可选的 callback_url 放在请求根级。所有工作流参数（包括输出选项）都放在 input 内。 只发送本工作流支持的 input 字段。不支持的 input 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)、包含主机名，且不含内嵌凭证。

​

提示词

• prompt：必填。描述要做的修改。长度：1-2,000 个字符。
• 提供时不能为空。

​

图像 URL

• image_urls：必填。提供公开可访问的图像 URL。1-10 项。每项都必须是 HTTP(S) URL。

​

主体元素

• elements：可选。提供主体参考对象。传入数组，每项为一个对象。
• elements[].frontal_image_url：可选。使用公开可访问的 HTTP(S) URL。
• elements[].reference_image_urls：可选。提供数组。每项都必须是 HTTP(S) URL。

在提示词中以 @Element1、@Element2 等引用主体。元素对象可以包含其他字段；未规定元素数量上限。

​

计费因素

计费取决于输出分辨率（resolution）和输出图像数量（n）。文生图和图像编辑使用相同的计费标准。参考图和主体元素不会额外计费。 积分在提交时扣除，任务失败会退还。