Skip to content

Omni 图像 ​

接口与可灵官网一致;支持 Omni Image O1 与 Kling Image 3.0 Omni

  • 路径 POST /kling/v1/images/omni-image
  • 与官网一致:本页所有请求体、字段命名与返回结构与可灵官网保持一致
  • 字段详解:请参考官网权威文档

请求参数

参数类型必填说明
model_namestring否模型名称,默认 kling-image-o1。可选:kling-image-o1、kling-v3-omni
promptstring是文本提示词
image_listarray否参考图片列表
element_listarray否主体参考列表
resolutionstring否清晰度:1k/2k;kling-v3-omni 额外支持 4k
nint否生成图片数量 [1,9]
aspect_ratiostring否纵横比:16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、auto
watermark_infoobject否是否生成含水印结果
callback_urlstring否回调通知地址
external_task_idstring否自定义任务ID

请求体补充说明

  • prompt:支持通过 <<<image_1>>> 引用图片占位符;长度 ≤ 2500 字符
  • model_name 仅支持 kling-image-o1、kling-v3-omni。
  • image_list 结构:
    • 字段:image(URL 或 Base64,官方上游字段)
    • 兼容:image_url(平台兼容输入,转发上游时会映射为 image)
    • 约束:.jpg/.jpeg/.png;大小 ≤ 10MB;最小边 ≥ 300px;宽高比 1:2.5 ~ 2.5:1
  • element_list 结构:[{ "element_id": }]
    • 参考图片数量 + 主体数量 ≤ 10
  • resolution:默认 1k;n 默认 1;kling-image-o1 仅允许 1k/2k,kling-v3-omni 允许 1k/2k/4k
  • aspect_ratio:
    • 默认 auto,按输入内容智能生成
    • 当以参考图原始比例生成时,该参数不生效

场景一:图片参考生成 ​

bash
curl --request POST \
  --url https://aiapi.fhddos.com/kling/v1/images/omni-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-image-o1",
    "prompt": "<<<image_1>>>同风格的科幻城市",
    "image_list": [
      {"image": "https://example.com/ref.jpg"}
    ],
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "n": 1
  }'

示例响应(创建任务)

json
{
  "code": 0,
  "message": "success",
  "request_id": "req_...",
  "data": {
    "task_id": "task_01...",
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}

OpenAPI ​

yaml
openapi: 3.0.3
info:
  title: Fhddos Core API
  version: '1.0'
  description: >-
    Core OpenAI-compatible and model-family endpoints used by the Fhddos user
    docs.
servers:
  - url: https://aiapi.fhddos.com
security:
  - BearerAuth: []
paths:
  /kling/v1/images/omni-image:
    post:
      tags:
        - Kling
      summary: Kling omni image
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          $ref: '#/components/responses/JsonObject'
components:
  requestBodies:
    JsonObject:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GenericObject'
  responses:
    JsonObject:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GenericObject'
  schemas:
    GenericObject:
      type: object
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <token>'

Fhddos AI 用户文档