GRGlobalRouter Docs
Console

Images / POST

Create images

OpenRouter 风格create图片，可returns URL 或 b64_json。

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异步图片任务状态、产物和计费摘要。
POST/api/v1/images

适合文生图、带参考图的图片生成，或需要单独控制图片parameters和returns格式的 OpenRouter 兼容场景。

Back to Images endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesGlobalRouter model ID that supports image generation.
promptstringYesImage generation prompt.
aspect_ratiostringNo画幅比例，例如 1:1、16:9、9:16、auto。不要与 size 同时传。
backgroundstringNo背景模式，支持 auto、transparent、opaque。
input_referencesobject[]No参考图列表，每项为 { type: "image_url", image_url: { url } }；兼容省略 type 的旧格式。支持 HTTP(S) URL 或 data:image/ base64 data URL。
input_references[].typestringNo参考图类型。传入时必须为 image_url。
input_references[].image_url.urlstringYes参考图 URL，支持 HTTP(S) URL 或 data:image/ base64 data URL。
nintegerNoNumber of images to generate, from 1 to 10.
output_compressionintegerNoOutput compression quality from 0 to 100.
output_formatstringNo产物格式，支持 png、jpeg、webp、svg。
providerobjectNoProvider selection and provider-specific options.
provider.provider_idstringNoProvider ID used to route the request, for example doubao.
provider.optionsobjectNoProvider-keyed options, for example { doubao: { ... } }.
qualitystringNo质量档位，支持 auto、low、medium、high。
resolutionstringNo分辨率档位，支持 512、1K、2K、4K。不要与 size 同时传。
response_formatstringNoresponses格式。Allowed values: `url`, `b64_json`。Default: `b64_json`。
seedintegerNoRandom seed.
sizestringNo图片尺寸或档位。不要与 resolution 或 aspect_ratio 同时传。
streambooleanNoWhether to stream when the provider supports it.

Response fields

FieldTypeRequiredDescription
createdintegerYesCreation timestamp.
dataobject[]Yes图片结果。每项按 response_format 包含 url 或 b64_json，可包含 media_type。
data[].b64_jsonstringNoBase64 图片内容，不包含 data URL 前缀。
data[].urlstringNo可访问的 HTTP(S) 图片 URL。
data[].media_typestringNo图片 MIME 类型；无法可靠确定时省略。
usageobjectNo用量摘要，可能包含 cost、cost_details 等字段。

Errors

400ROUTER_IMAGE_SIZE_CONFLICT

size was provided together with resolution or aspect_ratio.

400ROUTER_IMAGE_REFERENCE_INVALID

input_references 格式或 image_url.url 不合法。

Notes

  • response_format 默认为 b64_json；传 url 时returns Provider 原始 HTTP(S) URL，或复用现有 TOS 产物链路returns签名 URL。
  • url 与 b64_json responses都兼容可选 media_type；无法可靠确定时省略，不会为了探测 MIME 额外下载图片。
  • 需要长耗时、批量生产或后台轮询场景时，使用 Create image task。