You need to enable JavaScript to run this app.
veImageX

veImageX

请输入
  • 文档首页
    • veImageXAPI 参考veImageX × 豆包 AIGC查询文生图异步任务
复制全文
我的收藏
veImageX × 豆包 AIGC
查询文生图异步任务
复制全文
我的收藏
查询文生图异步任务

本接口支持获取文生图异步任务生成的结果图地址。

使用说明

本段主要介绍如何获取调用时的参数信息，以及获取后在本接口的具体传参位置。

  1. 获取 veImageX 配置信息：服务 IDServiceId。
  2. 获取创建完成的任务 ID。
  3. 根据查询通用2.0-文生图异步任务模型对应的接口文档，完成 ModelAction、ModelVersion 和 ReqJson 这个三个参数的填写。

注意事项

  • 请求频率：请遵循图像生成大模型中的智能绘图的 QPS 限制。
  • 超时时间：超时时间为 30 秒。
  • 服务地址：veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。具体详情请查看服务地址。

请求说明

  • 请求方式：POST
  • 请求地址：https://imagex.volcengineapi.com/?Action=GetCVImageGenerateTask&Version=2023-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数类型是否必选示例值描述
ActionString是GetCVImageGenerateTask接口名称。当前 API 的名称为 GetCVImageGenerateTask。
VersionString是2023-05-01接口版本。当前 API 的版本为 2023-05-01。
ServiceIdString是serviceid指定要查询的服务 ID。

Body

参数类型是否必选示例值描述
TaskIdString是7418048504813240370指定文生图异步任务的任务 ID。
ModelActionString是CVSync2AsyncSubmitTask查询通用2.0-文生图异步任务模型接口的 Action 名称，即 CVSync2AsyncGetResult。
ModelVersionString是2022-08-31查询通用2.0-文生图异步任务模型接口的 Version 名称，即 2022-08-31。

ReqJson

JSON Map

是

{
    "req_key": "high_aes_general_v20_L",
    "task_id": "7418049665255653414"
}

查询通用2.0-文生图异步任务模型接口的请求 JSON 字符串。
若仅指定必填参数，则 ReqJson 取值示例如下所示：

{
    "req_key": "high_aes_general_v20_L",
    "task_id": "7418049665255653414"
}

说明

您可忽略 return_url，该参数的取值并不会影响最终返回的结果图地址的类型。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数类型示例值描述

Status

String

done

任务状态，取值如下所示：

  • in_queue：任务已提交
  • generating：任务处理中
  • done：任务处理完成
  • not_found：任务未找到，可能原因是无此任务或任务已过期（12小时）
TaskIdString7418048504813240370任务 ID
ImageUrlsArray of String["http://test.example.cn/demo1~tplv-serviceid-image.image"]最终上传至 veImageX 服务的结果图访问 URL，数量为 1。

RespJson

JSON Map

{
    "code": 10000,
    "data": {
        "binary_data_base64": null,
        "image_urls": [
            "https://xxxx"
        ],
        "status": "done"
    },
    "message": "Success",
    "request_id": "2025061718460554C9B78D23B0BAB45B2A",
    "time_elapsed": "508.312154ms"
}

根据查询通用2.0-文生图异步任务模型接口信息，接收的该接口响应的 JSON 数据。

StoreUrisArray of String["tos-cn-i-serviceid/demo1"]结果图存储 URI，数量为 1。

请求示例 

POST https://imagex.volcengineapi.com/?Action=GetCVImageGenerateTask&Version=2023-05-01&ServiceId=serviceid
{
    "TaskId": "7418048504813240370",
    "ReqJson": {
        "req_key": "high_aes_general_v20_L",
        "task_id": "7418049665255653414"
    },
    "ModelAction": "CVSync2AsyncSubmitTask",
    "ModelVersion": "2022-08-31"
}

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetCVImageGenerateTask",
        "Version": "2023-05-01",
        "Service": "ImageX",
        "Region": "cn-north-1"
    },
    "Result": {
        "Status": "done",
        "ImageUrls": [
            "http://test.example.cn/demo1~tplv-serviceid-image.image"
        ],
        "RespJson": {
            "code": 10000,
            "data": {
                "binary_data_base64": null,
                "image_urls": [
                    "https://xxxx"
                ],
                "status": "done"
            },
            "message": "Success",
            "request_id": "2025061718460554C9B78D23B0BAB45B2A",
            "time_elapsed": "508.312154ms"
        },
        "TaskId": "7418048504813240370",
        "StoreUris": [
            "tos-cn-i-serviceid/demo1"
        ]
    }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码和 veImageX 错误码。

服务端 SDK

veImageX 提供了配套的开发工具集 SDK，支持多种编程语言，帮助您更方便的调用 API。

最近更新时间：2026.02.06 12:41:59
这个页面对您有帮助吗？
有用
有用
无用
无用