GRGlobalRouter Docs
Console

Text / POST

Create a message

Messages-style text endpoint.

Endpoints

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

MethodEndpointDescription
POST/api/v1/responsesResponses-style text endpoint.
POST/api/v1/messagesMessages-style text endpoint.
POST/api/v1/embeddingscreate文本向量，支持通过 provider 和 routing 指定豆包 Provider。
POST/api/v1/messages

Useful when organizing multi-turn context as a messages array and returning a message object.

Back to Text endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesGlobalRouter text model ID.
modelsstring[]NoOpenRouter 风格models候选列表；未传 model 时使用第一项。
messagesarrayYesMulti-turn messages containing role and content.
providerstringNoSpecify provider preferences.
streambooleanNoWhether to use streaming output.
temperaturenumberNoSampling temperature.
top_pnumberNoNucleus sampling probability.
max_tokensintegerNoMaximum output token count.
max_completion_tokensintegerNomax_tokens 的兼容别名。
toolsobject[]NoTool call definitions.
tool_choicestring | objectNo工具选择策略。
response_formatobjectNoStructured output configuration.
stopstring | string[]NoStop sequences.
userstringNoApplication-side user identifier.
_routerobjectNo路由元信息；会合并到 router metadata。
metadataobjectNo业务侧或路由元信息。

Response fields

FieldTypeRequiredDescription
idstringYesmessage ID。
typestringYesmessage。
rolestringYesassistant。
modelstringYesActual model ID used.
contentobject[]YesText content part.
stop_reasonstringNo停止原因。
usageobjectNoToken usage.
openrouter_metadataobjectNoMetadata such as provider and generation_id.