交易平台image-异步任务模型
Images generations
请求说明
- 基本信息
请求地址：https://api-ml.tiangangaitp.com/v1/images/generations
请求方式：POST
- Header参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | String | 是 | 固定值application/json |
| Authorization | String | 是 | "Bearer" + Apikey |
- Body参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
| prompt | string | 是 | 正向提示词，用来描述生成图像中期望包含的元素和视觉特点。 |
| negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制。 |
| image | string | 否 | Qwen-Image-Edit-2509必选，输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。多图输入时，按照数组顺序定义图像顺序，输出图像的比例以最后一张为准。 |
| image2 | string | 否 | Qwen-Image-Edit-2509必选，输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。多图输入时，按照数组顺序定义图像顺序，输出图像的比例以最后一张为准。 |
| image3 | string | 否 | Qwen-Image-Edit-2509必选，输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。多图输入时，按照数组顺序定义图像顺序，输出图像的比例以最后一张为准。 |
| negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制。支持Qwen-Image，Qwen-Image-Edit-2509。 |
| image_size | string | 否 | 生成图像的分辨率。Qwen-Image目前支持1328*1328, 1664*928, 928*1664, 1472*1104, 1104*1472, 1056*1584，默认为1328*1328。 Z-Image-Turbo目前支持1024*1024, 1024*768, 768*1024, 默认值为1024*1024 。 Qwen-Image-Edit-2509若未指定该参数，系统将默认生成总像素为 1280*1280的图像，并按以下规则保持宽高比（近似值）,单图输入：宽高比与输入图像一致；多图输入：宽高比与最后一张输入图像一致, 其他的支持1280*1280, 1024*1024, 800*1200, 1200*800, 960*1280, 1280*960, 720*1280, 1280*720, 1344*576 |
| seed | int | 否 | 图片生成时候的种子值，如果不提供，则算法自动用一个随机生成的数字作为种子。 |
响应说明
- 响应头参数
| 名称 | 类型 | 描述 |
|---|---|---|
| taskId | string | 任务id |
| taskStatus | string | 任务状态，包括SUCCEEDED, FAILED, CANCELED, PENDING, SUSPENDED, RUNNING |
请求示例
示例如下，请将参数示例值替换为实际值。
- 纯文本请求示例
powershell
curl --request POST \
--url https://api-ml.tiangangaitp.com/v1/images/generations \
--header "Authorization: Bearer $API_KEY" \
--data '{
"model": "Qwen-Image",
"prompt": "奔跑的小猫",
"image_size": "1328*1328",
"seed": 42
}'curl --request POST \
--url https://api-ml.tiangangaitp.com/v1/images/generations \
--header "Authorization: Bearer $API_KEY" \
--data '{
"model": "Qwen-Image",
"prompt": "奔跑的小猫",
"image_size": "1328*1328",
"seed": 42
}'- 响应结果
powershell
{
"code": 100000,
"msg": "SUCCESS",
"data": {
"taskId": "4n3buLFnFRF5CgRXOrg7PK",
"taskStatus": "PENDING"
}
}{
"code": 100000,
"msg": "SUCCESS",
"data": {
"taskId": "4n3buLFnFRF5CgRXOrg7PK",
"taskStatus": "PENDING"
}
}getTaskResult
请求说明
- 基本信息
请求地址：https://api-ml.tiangangaitp.com/v1/tasks/{taskId}
请求方式：POST
- Header参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | String | 是 | 固定值application/json |
- url 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| taskId | string | 是 | taskId |
响应说明
- 响应头参数
| 名称 | 类型 | 描述 |
|---|---|---|
| taskId | string | 任务id |
| taskStatus | string | 任务状态，包括SUCCEEDED, FAILED, CANCELED, PENDING, SUSPENDED, RUNNING |
| url | string | 文件地址 |
请求示例
示例如下，请将参数示例值替换为实际值。
- 纯文本请求示例
powershell
curl --request GET \
--url https://api.tiangangaitp.com/v1/tasks/{taskId}curl --request GET \
--url https://api.tiangangaitp.com/v1/tasks/{taskId}- 响应结果
powershell
{
"code": 100000,
"msg": "SUCCESS",
"data": {
"url": "http://publicread.tiangangaitp.com/model/image/xxx.png",
"taskId": "4n3buLFnFRF5CgRXOrg7PK",
"taskStatus": "SUCCEEDED"
}
}{
"code": 100000,
"msg": "SUCCESS",
"data": {
"url": "http://publicread.tiangangaitp.com/model/image/xxx.png",
"taskId": "4n3buLFnFRF5CgRXOrg7PK",
"taskStatus": "SUCCEEDED"
}
}