主题
创建任务
POST
https://az.gptplus5.com/tencent-vod/v1/aigc-image
官方文档:https://cloud.tencent.com/document/product/266/126240
请求参数
Authorization
在 Header 添加参数Authorization，其值为在 Bearer 之后拼接 Token
示例：Authorization: Bearer ********************
Header 参数
| 参数名 | 类型 | 必需 | 说明 | 示例 |
|---|---|---|---|---|
Authorization | string | 可选 | Bearer {{YOUR_API_KEY}} | |
Content-Type | string | 可选 | application/json |
Body 参数 (application/json)
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
model_name | string | 必需 | 模型名称。取值： GEM：Gemini； Qwen：千问。 Hunyuan：混元。 示例值：GEM |
model_version | string | 必需 | 模型版本。取值： 当 ModelName 是 GEM，可选值为 2.5、3.0； 当 ModelName 是 Qwen，可选值为 0925； 当 ModelName 是 Hunyuan，可选值为 3.0； 示例值：2.5 |
prompt | string | 必需 | |
file_infos | array[object] | 可选 | |
└ type | string | 可选 | 输入的视频文件类型。取值有： File：点播媒体文件； Url：可访问的 URL； 示例值：File |
└ file_id | string | 可选 | 图片文件的媒体文件 ID，即该文件在云点播上的全局唯一标识符，在上传成功后由云点播后台分配。可以在 视频上传完成事件通知 或 云点播控制台 获取该字段。当 Type 取值为 File 时，本参数有效。 说明： 1. 推荐使用小于7M的图片； 2. 图片格式的取值为：jpeg，jpg, png, webp。 示例值：3704211***509819 |
└ url | string | 可选 | 可访问的文件 URL。当 Type 取值为 Url 时，本参数有效。 说明： 1. 推荐使用小于7M的图片； 2. 图片格式的取值为：jpeg，jpg, png, webp。 示例值：https://test.com/1.png |
└ text | string | 可选 | 输入图片的描述信息，用于帮助模型理解图片。仅GEM 2.5、GEM 3.0 有效。 示例值：任务背景：这是需要翻新的主建筑（图1），不得改变其几何结构。 |
negative_prompt | string | 可选 | 要阻止模型生成图片的提示词。 |
enhance_prompt | string | 可选 | 是否自动优化提示词。开启时将自动优化传入的 Prompt，以提升生成质量。取值有： Enabled：开启； Disabled：关闭； |
output_config | object | 可选 | 生图任务的输出媒体文件配置。 |
└ storage_mode | string | 可选 | 存储模式。取值有： Permanent：永久存储，生成的图片文件将存储到云点播，可在事件通知中获取到 FileId； Temporary：临时存储，生成的图片文件不会存储到云点播，可在事件通知中获取到临时访问的 URL； 默认值：Temporary |
└ resolution | string | 可选 | 生成图片的分辨率。可选值为 720P、1080P、2K、4K、1024x1024、2048x2048、2304x1728、2496x1664、2560x1440、3024x1296、4096x4096、4694x3520、4992x3328、5404x3040、6198x2656，其中使用模型 Jimeng 时，推荐通过 Prompt 指定图片分辨率和宽高比。 示例值：1024x1024 |
└ aspect_ratio | string | 可选 | 指定所生成图片的宽高比。 当 ModelName 是 GEM，可选值是 1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9 和 21:9； 当 ModelName 是 Qwen、Jimeng，则暂不支持，其中 Jimeng 会结合 Prompt意图、参考图片尺寸，由模型智能判断输出图片的宽高比。 示例值：16:9 |
└ person_generation | string | 可选 | 是否允许人物或人脸生成。取值有： AllowAdult：允许生成成人； Disallowed：禁止在图片中包含人物或人脸； 示例值：AllowAdult |
└ input_compliance_check | string | 可选 | 是否开启输入内容的合规性检查。取值有： Enabled：开启； Disabled：关闭； 示例值：Enabled |
└ output_compliance_check | string | 可选 | 是否开启输出内容的合规性检查。取值有： Enabled：开启； Disabled：关闭； 示例值：Enabled |
session_id | string | 可选 | 用于去重的识别码，如果三天内曾有过相同的识别码的请求，则本次的请求会返回错误。最长 50 个字符，不带或者带空字符串表示不做去重。 示例值：mysession |
session_context | string | 可选 | 来源上下文，用于透传用户请求信息，音画质重生完成回调将返回该字段值，最长 1000 个字符。 示例值：mySessionContext |
tasks_priority | string | 可选 | 任务的优先级，数值越大优先级越高，取值范围是 -10 到 10，不填代表 0。 示例值：10 |
ext_info | string | 可选 | 保留字段，特殊用途时使用。 示例值：myextinfo |
请求示例
json
{
"model_name": "GEM",
"model_version": "3.0",
"file_infos": [
{
"type": "file",
"file_id": "387702299774574677",
"url": "",
"text": "原始图片的描述信息"
}
],
"prompt": "convert this image to anime style",
"negative_prompt": "blur, distorted",
"enhance_prompt": "Enabled",
"output_config": {
"storage_mode": "Temporary",
"resolution": "1080P",
"aspect_ratio": "1:1",
"person_generation": "AllowAdult",
"input_compliance_check": "Enabled",
"output_compliance_check": "Enabled"
},
"session_id": "image-task-67890",
"session_context": "{\"user_id\": \"123\", \"scene\": \"profile_picture\"}",
"tasks_priority": 10,
"ext_info": ""
}cURL 示例
bash
curl --location --request POST 'https://az.gptplus5.com/tencent-vod/v1/aigc-image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model_name": "GEM",
"model_version": "3.0",
"file_infos": [
{
"type": "file",
"file_id": "387702299774574677",
"url": "",
"text": "原始图片的描述信息"
}
],
"prompt": "convert this image to anime style",
"negative_prompt": "blur, distorted",
"enhance_prompt": "Enabled",
"output_config": {
"storage_mode": "Temporary",
"resolution": "1080P",
"aspect_ratio": "1:1",
"person_generation": "AllowAdult",
"input_compliance_check": "Enabled",
"output_compliance_check": "Enabled"
},
"session_id": "image-task-67890",
"session_context": "{\"user_id\": \"123\", \"scene\": \"profile_picture\"}",
"tasks_priority": 10,
"ext_info": ""
}'返回响应
🟢200成功
响应 Body
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
status | string | 必需 | |
request_id | string | 必需 | |
response_url | string | 必需 | |
status_url | string | 必需 | |
cancel_url | string | 必需 | |
logs | null | 必需 | |
metrics | object | 必需 | |
queue_position | integer | 必需 |
响应示例
json
{
"Response": {
"TaskId": "251007502-AigcImage***2782aff1e896673f1ft",
"RequestId": "f50d7667-72d8-46bb-a7e3-0613588971b6"
}
}