POST/kling/v1/images/omni-image

Omni-Image

API Key application/json

Request

请求

/kling/v1/images/omni-image

Body

必填

Bodyobject

model_namestring必填

模型名称枚举值：kling-image-o1,kling-v3-omni

promptstring必填

文本提示词，可包含正向描述和负向描述可将提示词模板化来满足不同的图像生成需求不能超过2500个字符

image_listarray<object>

参考图列表

元素object

imagestring

resolutionstring

生成图片的清晰度枚举值：1k, 2k 1k：1K标清 2k：2K高清

ninteger

生成图片数量取值范围：[1,9]

result_typestring

生成结果单图/组图切换开关枚举值：single，series

series_amountinteger

生成组图的图片数量 ● 取值范围：[2, 9] 当result_type值为single时，当前参数无效

aspect_ratiostring

生成图片的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto 其中：auto为根据传入内容智能生成视频参考原图横纵比生成新图时，当前参数无效

watermark_infoobject

是否同时生成含水印的结果 ● 通过enabled参数定义，用key:value承载，如下：： "watermark_info": { "enabled": boolean // true 为生成，false 为不生成 } ● 暂不支持自定义水印

enabledboolean必填

callback_urlstring

external_task_idstring

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/images/omni-image \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-image-o1",
    "prompt": "生成一张海边跳舞的图片",
    // "image_list": [
    //     {
    //         "image": "https://p2-fdl.klingai.com/ksc2/z3PF_5x5kcBzfxZU-uZ66pg5k_lhpifyoCyTFjn_jsKOiBYQGMoR7_kLKO34JyIdJbCSKR3vRneCwiyPHHjTPk01J7Dr65Ovoa7vYQuEh9c4j1_0G03JjIyKUMI58c29jou3zMmAyhzg7p8CrG7esV5agnr2P9XuO5VdTKdr0sUjEDycWEFe07ajsaYFg-wCu7vTJGLD0cr3nvYKnUl-CA.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAEeMBuZg7aCbU7N7Rcp5oJ-kfGAN3V073p1GMw7U9oTuISV4gRwnqW7X62AbPhPQVRmzngQDHsFrcGU8kCtzGOJEUWdikBNDmI_JPyD4jpae40CyqnscoIaQhbakFkkDSf515oxxHoFKX2uekXxhaC-Ux41JUupV2RFEPtWRqJtZy4w5ozqI6jbHeVXI7LP_zHpYOGuULmTPK93QFpw13NYPzMPddw3UIRVMrgRQxivnBoS0TR4h_eyjkvDOmDeFijUb3cSIiCmxVk1M5S1rqBZGCnxiZ3evpByg-3YWaVjVOSCzNW4rCgFMAE&x-kcdn-pid=112757&pkey=AAXAHqkraVdXL-kd_qQmLBUx0arOSG4SaHfdeXdQqN5MCBxYZ4QHE_nMRaT_7H8WHOAkbT65kOvXwPx8qkIAOsrbUM980pOy5e_FSqUqJgc_1oYe5msfxxfxRU6wi85LgDw"
    //     }
    // ],
    "element_list": [
        {
            "element_id": 835266081714884677
        }
    ],
    "resolution": "",
    "n": 1,
    "aspect_ratio": "",
    "callback_url": "",
    "external_task_id": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object