Skip to main content
POST
cURL

Примеры

Стриминг

При stream: true ответ передаётся через SSE. Каждый чанк имеет вид:
Неизвестные параметры передаются провайдеру как есть. Ошибки для неподдерживаемых параметров (например, tools, response_format) приходят от провайдера, а не от Routify.

Авторизации

Authorization
string
header
обязательно

Bearer authentication header of the form Authorization: Bearer $ROUTIFY_API_KEY.

Тело

application/json
model
string
обязательно

Model ID used to generate the response. Use GET /v1/models to list all available models.

messages
object[]
обязательно

A list of messages comprising the conversation so far.

Minimum array length: 1
stream
boolean
по умолчанию:false

If set to true, the response is streamed to the client as it is generated using server-sent events. The stream ends with data: [DONE].

max_tokens
integer

An upper bound for the number of tokens that can be generated in the completion.

Требуемый диапазон: x >= 1
reasoning_effort
enum<string>

Constrains effort on reasoning for reasoning models (e.g. o3, o4-mini). Supported values: low, medium, high, xhigh. Lower effort reduces latency and cost; higher effort improves accuracy on complex tasks.

Доступные опции:
low,
medium,
high,
xhigh
verbosity
enum<string>

Controls verbosity of the model response.

Доступные опции:
low,
medium,
high
reasoningSummary
enum<string>

Controls the format of reasoning summaries in the response. Supported values: auto, detail, concise.

Доступные опции:
auto,
detail,
concise
temperature
number

What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. We recommend altering this or top_p but not both.

Требуемый диапазон: 0 <= x <= 2
top_p
number

An alternative to sampling with temperature, called nucleus sampling, where the model considers only the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We recommend altering this or temperature but not both.

Требуемый диапазон: 0 <= x <= 1
stop

Up to 4 sequences where the API will stop generating further tokens. The returned text will not contain the stop sequence.

Ответ

Successful response (JSON or SSE stream)

id
string
обязательно

A unique identifier for the chat completion.

object
string
обязательно

The object type. Always chat.completion.

Allowed value: "chat.completion"
created
integer
обязательно

The Unix timestamp (in seconds) of when the chat completion was created.

model
string
обязательно

The model used for the chat completion.

choices
object[]
обязательно

A list of chat completion choices.

Minimum array length: 1
usage
object
обязательно