腾讯混元生图混元 OpenAI 兼容接口调用示例

混元生图  API 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 中使用 cURL 来调用混元大模型。您仅需要将 base_url 和 api_key 替换成混元的相关配置，不需要对应用做额外修改，即可无缝将您的应用切换到混元生图。
base_url：https://api.cloudai.tencent.com/。
api_key：需在 接入管理页面 进行创建和管理。
提交生成接口请求地址完整路径：https://api.cloudai.tencent.com/v1/aiart/submit。
提交查询接口请求地址完整路径：https://api.cloudai.tencent.com/v1/aiart/query。
混元生图 3.0
目前接口仅支持混元生图（3.0）接口，您可通过输入图片或文本，输出完整的图片，详情请参见 混元生图（3.0）。
1. 提交图片生成任务
【model】为混元生图模型版本，目前仅支持HY-Image-V3.0，对应 混元生图（3.0）接口 。
【prompt】对应混元生图（3.0）的【Prompt】参数。
【images】对应混元生图（3.0）的【Images.N】参数。
【size】对应混元生图（3.0）的【Resolution】参数。
请求中【extra_body】的参数是否必填以及传入形式与 混元生图（3.0） 一致（例如【seed】、【revise】）。
OpenAI 的其余请求参数，例如【output_compression】、【Input fidelity】、【input_image_mask】等目前暂不支持。
示例代码如下：
cURL
curl --location 'https://api.cloudai.tencent.com/v1/aiart/submit' \\
--header 'Authorization: sk-e********zzz' \\
--header 'Content-Type: application/json' \\
--data '{
    "model": "HY-Image-V3.0",
    "prompt": "在图片中增加一个橘猫",
    "size": "1024:1024",
    "images": [
        "https://ai.cos.ap-guangzhou.myqcloud.com/cat.png"
    ],
    "extra_body": {
        "seed": 84445,
        "revise": 0,
        "logo_add": 1,
        "logo_param": {
            "logo_rect": {
                "x": 0,
                "y": 0,
                "width": 100,
                "height": 50
            },
            "logo_url": "https://ai.cos.ap-guangzhou.myqcloud.com/logo.png"
        }
    }
}
﻿提交图片生成任务的返回值，示例代码如下：
cURL
{"request_id":"ed**********5","job_id":"1259088371-1************10-0"}
2. 查询图片生成任务
获取 job_id 后，可使用 job_id 查询对应生成任务，示例如下：
cURL
curl --location 'https://api.cloudai.tencent.com/v1/aiart/query' \\
--header 'Authorization: sk-e********zzz' \\
--header 'Content-Type: application/json' \\
--data '{
    "job_id":"1259088371-1******************10-0"
}
返回值：
cURL
{
"request_id":"24****************3f0",
"status":"5",
"data":[
{"url":"https://aiart**************************-0/0"}
]
﻿
﻿
混元 OpenAI 兼容接口调用示例

本页目录：

混元生图 3.0
