异步图像结果查询

GET

/v1/async/images/result

查询Flux异步图像生成任务的状态和结果。通过提交图像生成请求时返回的task_id来查询生成进度和获取最终的图像结果。

任务状态说明：

pending：任务排队中

processing：任务处理中

succeeded：任务成功完成

failed：任务失败

响应说明：

当任务状态为 'succeeded' 时，image_urls 数组将包含生成的图像URL链接。

Request

Query Params

taskid

string

required

图像生成任务ID，即提交图像生成请求时返回的id

Header Params

Authorization

string

optional

API 鉴权 Token，格式为 Bearer {API_KEY}

Example:

Bearer BSKIUyOcr0s1cdyWA40e6eF11c974b188aFdFc0693Ff0959

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v1/async/images/result?taskid=' \
--header 'Authorization: Bearer BSKIUyOcr0s1cdyWA40e6eF11c974b188aFdFc0693Ff0959'

Responses

🟢200OK

application/json

图像生成结果查询成功

Body

task_id

string

required

任务ID

Example:

959df1cc-4e95-4bcc-a2d0-b4f113cddb2b

image_id

string

required

图像ID，通常与task_id相同

Example:

959df1cc-4e95-4bcc-a2d0-b4f113cddb2b

task_status

enum<string>

required

任务状态

Allowed values:

pendingprocessingsucceededfailed

Example:

succeeded

message

string

required

响应消息，成功时通常为空，失败时包含错误信息

Example:

image_urls

array[string <uri>]

required

生成的图像URL数组，任务成功时包含图像链接

Example:

["https://example.com/generated_image.jpg"]

Example

{
    "task_id": "959df1cc-4e95-4bcc-a2d0-b4f113cddb2b",
    "image_id": "959df1cc-4e95-4bcc-a2d0-b4f113cddb2b",
    "task_status": "pending",
    "message": "",
    "image_urls": [
        "https://example.com/generated_image.jpg"
    ]
}

🟠404Record Not Found

Modified at 2025-07-16 07:16:45

可灵绘图

异步图像结果查询

任务状态说明：#

响应说明：#

Request

Request samples

Responses

任务状态说明：

响应说明：