GRGlobalRouter Docs
Console

Chat / POST

Create image from Chat

Requests image output from a Chat call.

Endpoints

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

MethodEndpointDescription
POST/api/v1/chat/completionsCreates a chat completion.
POST/api/v1/chat/completionsRequests image output from a Chat call.
POST/api/v1/videosCreate an OpenRouter-compatible video job from chat context.
POST/api/v1/chat/completions

Useful for applications that already organize context with messages. After passing `modalities: ["image"]`, image results are returned in message.images.

Back to Chat endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesGlobalRouter model ID that supports image output.
messagesarrayYesChat-style context.
modalitiesstring[]YesTriggers image output when image is included.
providerstringNoSpecify provider preferences.
routingobjectNoRouting preference, such as provider or strategy tags.
image_configobjectNo图片配置，可包含 aspect_ratio、resolution、quality、response_format 等字段。
input_referencesobject[]NoReference image list. Each item contains a url and supports HTTP(S) URLs or data:image/base64 data URLs.
nintegerNoNumber of images to generate.
sizestringNo图片尺寸；不要与 resolution 或 aspect_ratio 同时传。
aspect_ratiostringNoAspect ratio, such as 1:1, 16:9, or 9:16.
resolutionstringNoResolution tier.
qualitystringNoQuality tier; supported values depend on the model.
stylestringNoStyle parameter; supported values depend on the model.
seedintegerNoRandom seed.
userstringNoApplication-side user identifier.
response_formatstringNoreturns url 或 b64_json。
output_formatstringNoArtifact format, such as png, jpeg, or webp.
backgroundstringNo背景模式。
output_compressionintegerNoOutput compression quality from 0 to 100.
moderationobjectNoProvider 支持时的审核配置。
streambooleanNoWhether to return SSE streaming responses.

Response fields

FieldTypeRequiredDescription
idstringYesChat completion ID。
choicesobject[]YesChat response list.
choices[].message.imagesobject[]NoGenerated image list; image URLs are in image_url.url.
usageobjectNoUsage summary.
openrouter_metadataobjectNoRequest metadata.