GRGlobalRouter Docs
Console

Images / GET

Get image task

query异步图片任务状态、产物和计费摘要。

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/api/v1/imagesOpenRouter 风格create图片，可returns URL 或 b64_json。
POST/api/v1/image-taskscreate异步图片生成任务，并通过 polling_url query完成状态。
GET/api/v1/image-tasks/{image_task_id}query异步图片任务状态、产物和计费摘要。
GET/api/v1/image-tasks/{image_task_id}

用于轮询 Create image task returns的 image.task。query只读取持久化任务状态，不触发 provider poll，也不会新增扣费；任务归属由 API Key 所属租户判断。

Back to Images endpoint list

Request parameters

FieldTypeRequiredDescription
image_task_idstringYes路径parameters，Create image task returns的 GR 图片任务 ID，例如 imgtask_xxx。

Response fields

FieldTypeRequiredDescription
idstringYesGR 虚拟图片任务 ID。
objectstringYes固定为 image.task。
statusstringYesqueued、submitting、submitted、in_progress、completed、failed、expired 等。
modelstringYescreate任务时请求的models。
providerstringYescreate任务时固定的 provider。
polling_urlstringYesquery任务状态的相对 URL。
created_atintegerNo任务create时间，Unix 秒。
updated_atintegerNo任务update时间，Unix 秒。
completed_atintegerNo任务完成时间，Unix 秒。
dataobject[]Nocompleted 后returns图片明细。
data[].urlstringNoImage URL.
data[].b64_jsonstringNoBase64 image content.
data[].media_typestringNo图片 MIME 类型。
usageobjectNo后台 poll worker 完成计费后的用量摘要。
errorobjectNo失败原因。
metadataobjectNocreate任务时写入的客户端元数据。

Errors

401ROUTER_AUTHENTICATION_FAILED

缺少或无效 API Key。

404ROUTER_IMAGE_TASK_NOT_FOUND

任务不存在，或不属于当前 API Key 所属租户。

Notes

  • GET query只读持久化状态，不触发 provider poll，也不触发新增扣费。
  • 如果任务仍在 queued、submitted 或 in_progress，客户端应继续轮询 polling_url。
  • completed 后 data returns图片 URL 或 b64_json，failed/expired 时查看 error。