获取文生图结果
1. 接口地址
https://www.hidreamai.com/api-pub/gw/v3/image/txt2img/async/results
2. 请求方式
GET
3. 请求参数
Header
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 客户授权Token |
Query Params
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 提交任务时返回的task_id |
| request_id | string | 否 | 请求的ID，默认为"" |
curl示例
curl -H 'Authorization: Bearer {USER_Authorization}' -X GET
-v 'https://www.hidreamai.com/api-pub/gw/v3/image/txt2img/async/results?task_id=b2781982-5c57-11ee-bf2b-f6f8d60dadec&request_id=425d6094-3a73-11ee-85e2-0a4fb61b1c34'Python示例
import requests
USER_Authorization = <token>
task_id = "5f1219d0-d6b0-11ee-8816-52cbc25497eb" # <task_id>
# 请求头
headers = {
'Authorization': f'Bearer {USER_Authorization}'
}
# 请求参数
params = {
'task_id': task_id,
'request_id': ''
}
# 发送GET请求
url = 'https://www.hidreamai.com/api-pub/gw/v3/image/txt2img/async/results'
response = requests.get(url, headers=headers, params=params)
# 处理响应
if response.status_code == 200:
if response.json()['code'] == 0:
results = response.json()['result']['sub_task_results']
for result in results:
print(f"task_status: {result['task_status']}, task_completion: {result['task_completion']}, image_url: {result['image']}")
else:
print(response.json()['message'])
else:
print(response.status_code)
4. 返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回状态码 |
| message | string | 返回状态信息 |
| request_id | string | 本次请求的ID |
| result | dict | 返回结果 |
其中返回结果 result字段具体为：
| 参数 | 类型 | 说明 |
|---|---|---|
| task_id | string | 任务的task_id |
| sub_task_results | list | 各个子任务的生成结果 |
其中sub_task_results字段具体为
| 参数 | 类型 | 说明 |
|---|---|---|
| sub_task_id | string | 子任务的task_id |
| task_status | int | 子任务的状态，0: 等待中，1: 完成，2: 处理中，3: 失败，4: 未通过审核 |
| task_completion | float | 子任务的进度，取值范围为0-1的小数点后保留2位的小数 |
| image | string | 生成的图片的url, 如果需要提高分辨率可以使用.png替换.jpg, 也可使用?width=num来限制图片大小, eg.'https://storage.hidreamai.com/image/p_63f1670c-3a76-11ee-ad4f-eeed008884fa.jpg?width=512 (opens in a new tab)' |
| image_wm | string | 加水印的生成图片的URL |
示例：
{
"code": 0,
"message": "Success",
"request_id": "ff3e6820-aeb3-11ee-9560-7a559ddc3bd3",
"result": {
"sub_task_results": [{
"image": "https://storage.hidreamai.com/image/p_fdd71d4c-aeb3-11ee-a90f-00163e038297.jpg",
"image_wm": "https://storage.hidreamai.com/image/p_fdd71d4c-aeb3-11ee-a90f-00163e038297_wm.jpg",
"sub_task_id": "37e8b5cc-2e16-4998-a407-3ff8e95e3cd2",
"task_completion": 1,
"task_status": 1
}, {
"image": "https://storage.hidreamai.com/image/p_fda05488-aeb3-11ee-bf98-00163e012526.jpg",
"image_wm": "https://storage.hidreamai.com/image/p_fda05488-aeb3-11ee-bf98-00163e012526_wm.jpg",
"sub_task_id": "fd2c15c0-c8b0-4221-8732-583079c74310",
"task_completion": 1,
"task_status": 1
}],
"task_id": "e2ab2e28-aeb3-11ee-9c35-7a559ddc3bd3"
}
}