查询异步生图任务

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://api.naoshengyun.com/v1/images/generations/task/task_GKhuDmGlnT7WaSN50erytwCY9eX4LXMv' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200查询成功

application/json

查询成功。data 为完整异步图像任务详情；处理中任务的结果字段可能尚未生成，失败任务应关注 fail_reason。

Bodyapplication/json

示例

response_format=url 时的完整成功响应。

{
  "code": "success",
  "message": "",
  "data": {
    "id": 6,
    "created_at": 1790041833,
    "updated_at": 1790042020,
    "task_id": "task_syzLM9HO4D0Uw5luSE4hmEVUFU7dLWD6",
    "platform": "image",
    "user_id": 2,
    "group": "image-测试",
    "channel_id": 33,
    "quota": 0,
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://media-test.com/generated-images/20260922/qqBKc0K2ctS0QOoL2yleIMR6OCD2hQM0.png",
    "submit_time": 1790041833,
    "start_time": 1790041833,
    "finish_time": 1790042020,
    "progress": "100%",
    "properties": {
      "input": "未来城市上空的云端花园，电影概念设计",
      "upstream_model_name": "gpt-image-2",
      "origin_model_name": "gpt-image-2",
      "image_params": {
        "size": "1024x1024",
        "quality": "high",
        "response_format": "url",
        "n": 1
      }
    },
    "data": {
      "created": 1790042018,
      "images": [
        {
          "index": 0,
          "ref": "generated-images/20260922/qqBKc0K2ctS0QOoL2yleIMR6OCD2hQM0.png",
          "url": "https://media-test.com/generated-images/20260922/qqBKc0K2ctS0QOoL2yleIMR6OCD2hQM0.png",
          "bytes": 1974286
        }
      ],
      "n_actual": 1,
      "n_requested": 1,
      "output_format": "png",
      "response_format": "url",
      "usage": {
        "prompt_tokens": 20,
        "completion_tokens": 7024,
        "total_tokens": 7044,
        "prompt_tokens_details": {
          "cached_tokens": 0,
          "text_tokens": 20,
          "audio_tokens": 0,
          "image_tokens": 0
        },
        "completion_tokens_details": {
          "text_tokens": 0,
          "audio_tokens": 0,
          "image_tokens": 7024,
          "reasoning_tokens": 0
        },
        "input_tokens": 20,
        "output_tokens": 7024,
        "input_tokens_details": {
          "cached_tokens": 0,
          "text_tokens": 20,
          "audio_tokens": 0,
          "image_tokens": 0
        },
        "output_tokens_details": {
          "text_tokens": 0,
          "audio_tokens": 0,
          "image_tokens": 7024,
          "reasoning_tokens": 0
        }
      }
    }
  }
}