POST Responses

Responses API — формат, совместимый с OpenAI Responses API. Работает с официальным OpenAI SDK (client.responses.create(...)), Codex CLI и другими каноничными клиентами. Внутри запрос трансформируется в Chat Completions и уходит выбранному провайдеру.

Эндпоинты

Основные параметры

Alias-формат модели

К имени модели можно дописать параметры маршрутизации через @:

openai/gpt-6-astra@reasoning_effort=high&allow_fallbacks=false

Поддерживаемые ключи: provider, reasoning_effort, allow_fallbacks. При конфликте alias и одноимённого поля в теле запроса API вернёт 400.

Дополнительные параметры

Не поддерживаются

Эти поля принимаются ради совместимости с OpenAI SDK, но не влияют на результат:

Примеры

curl -X POST "https://api.usellm.ru/v1/responses" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "input": "Расскажи о квантовых компьютерах"
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.usellm.ru/v1",
    api_key="<USELLM_API_KEY>",
)

response = client.responses.create(
    model="openai/gpt-6-astra",
    input=[{"role": "user", "content": "Привет!"}],
    instructions="Отвечай кратко и по делу",
)

print(response.output_text)

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://api.usellm.ru/v1',
    apiKey: '<USELLM_API_KEY>',
});

const response = await client.responses.create({
    model: 'openai/gpt-6-astra',
    input: [{ role: 'user', content: 'Привет!' }],
    instructions: 'Отвечай кратко и по делу',
});

console.log(response.output_text);

Структура ответа

{
  "id": "gen_581761234567890123",
  "object": "response",
  "created_at": 1785312000,
  "completed_at": 1785312003,
  "model": "openai/gpt-6-astra",
  "status": "completed",
  "error": null,
  "output_text": "Квантовые компьютеры — это...",
  "output": [
    {
      "type": "message",
      "id": "msg_1785312000_0",
      "status": "completed",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Квантовые компьютеры — это...", "annotations": [] }]
    }
  ],
  "incomplete_details": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 148,
    "total_tokens": 160,
    "cost_rub": 0.0413
  }
}

status — completed, incomplete или failed. При incomplete заполняется incomplete_details.reason (max_output_tokens или content_filter).

В usage поля продублированы в двух неймингах: input_tokens/output_tokens (Responses API) и prompt_tokens/completion_tokens (Chat Completions) — используйте любой. cost_rub — фактическая стоимость запроса, списанная с баланса.

Tool calling

Поддерживается полный цикл: передача tools → получение function_call → отправка результата через function_call_output → финальный ответ модели.

Типы инструментов

1. Запрос с инструментами

{
  "model": "openai/gpt-6-astra",
  "input": [{ "role": "user", "content": "Какая погода в Москве?" }],
  "tools": [
    {
      "type": "function",
      "name": "get_weather",
      "description": "Получить текущую погоду в городе",
      "parameters": {
        "type": "object",
        "properties": { "location": { "type": "string", "description": "Название города" } },
        "required": ["location"]
      }
    }
  ],
  "tool_choice": "auto"
}

2. Ответ с вызовом инструмента

{
  "id": "gen_581761234567890123",
  "object": "response",
  "status": "completed",
  "output_text": "",
  "output": [
    {
      "type": "function_call",
      "id": "fc_call_abc123",
      "call_id": "call_abc123",
      "name": "get_weather",
      "arguments": "{\"location\":\"Москва\"}",
      "status": "completed"
    }
  ]
}

3. Возврат результата инструмента

Выполните функцию на своей стороне и отправьте новый запрос со всей историей: исходное сообщение пользователя, item function_call и item function_call_output с тем же call_id.

{
  "model": "openai/gpt-6-astra",
  "input": [
    { "role": "user", "content": "Какая погода в Москве?" },
    {
      "type": "function_call",
      "call_id": "call_abc123",
      "name": "get_weather",
      "arguments": "{\"location\":\"Москва\"}"
    },
    {
      "type": "function_call_output",
      "call_id": "call_abc123",
      "output": "{\"temp_c\": -3, \"condition\": \"снег\"}"
    }
  ],
  "tools": []
}

В поле tools второго запроса передайте те же определения инструментов, что и в первом.

Типы input items

Мультимодальный input

В content сообщения можно передать массив частей: input_text, input_image (URL или base64 data URI), input_file (base64 или URL). Подробнее — в гайде Передача медиа на вход.