Result – Hidream AI 开放平台

获取智能擦除结果

1. 接口地址

https://www.hidreamai.com/api-pub/gw/v3/images/image_erase/async/results

2. 请求方式

GET

3. 请求参数

Header

参数	类型	是否必填	说明
Authorization	string	是	客户授权Token
X-accept-language	string	否	语言偏好，支持['en', 'zh']，en：英文，zh：中文，默认"zh"

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/images/image_erase/async/results?task_id=2b3cee2e-3aaa-11ef-9496-3a18d93f3388&request_id=425d6094-3a73-11ee-85e2-0a4fb61b1c34'

Python示例

import requests

USER_Authorization = <token>
task_id = "6fd16a7c-d6b1-11ee-af0a-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/outpainting/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_ids	list	各个子任务的生成结果

其中sub_task_result字段具体为

参数	类型	说明
image	list	擦除的图片的url列表, 其中，第一个表示轻擦除的结果，第二个表示重擦除的结果
image_wm	list	加水印的擦除图片的URL列表
sub_task_id	string	子任务的task_id
task_completion	float	子任务的进度，取值范围为0-1的小数点后保留2位的小数
task_status	int	子任务的状态，0: 等待中，1: 完成，2: 处理中，3: 失败，4: 未通过审核

示例

{
    "code":0,
    "message":"Success",
    "request_id":"128bfb62-884f-11ee-8ab6-451cb37c3789",
    "result":{
        "sub_task_results":[
            {
                "image":[
                    "https://storage.hidreamai.com/image/p_32f63dc8-3aaa-11ef-a2d4-764171c67bea.jpg",
                    "https://storage.hidreamai.com/image/p_336cc4de-3aaa-11ef-a2d4-764171c67bea.jpg"
                ],
                "image_wm":[
                    "https://storage.hidreamai.com/image/p_32f63dc8-3aaa-11ef-a2d4-764171c67bea_wm.jpg",
                    "https://storage.hidreamai.com/image/p_336cc4de-3aaa-11ef-a2d4-764171c67bea_wm.jpg"
                ],
                "sub_task_id":"0465305f-19b8-446c-be85-14d4541eddf7",
                "task_completion":1,
                "task_status":1
            }
        ],
        "task_id":"2b3cee2e-3aaa-11ef-9496-3a18d93f3388"
    }
}

智能擦除请求接口智能抠图