GRGlobalRouter Docs
Console

Text / POST

Create a response

Responses-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/responses

Useful when organizing text requests with `input` and reading results from the response/output structure.

Back to Text endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesGlobalRouter text model ID.
modelsstring[]NoOpenRouter 风格models候选列表；未传 model 时使用第一项。
instructionsstringNoResponses 风格系统指令，会转换为 system message。
inputstring or arrayYesText input or multipart input.
messagesarrayNo也可直接传 Chat 风格 messages。
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.
routingobjectNoRouting preference.
_routerobjectNo路由元信息；会合并到 router metadata。
metadataobjectNo业务侧或路由元信息。

Response fields

FieldTypeRequiredDescription
idstringYesresponse ID。
objectstringYesReturned object type.
created_atintegerNoCreation timestamp.
statusstringYescompleted or an error status.
modelstringYesActual model ID used.
outputobject[]YesOutput part list.
usageobjectNoToken usage.
openrouter_metadataobjectNoMetadata such as provider and generation_id.