~/ Документация API / responses

POST/responses

Эндпоинт в формате OpenAI Responses API — современная альтернатива chat/completions с полем input и встроенными инструментами.

https://api.aiadapter.ru/api/v1/responses

Параметры тела

modelstringrequiredМодель

Идентификатор модели из каталога.

inputstring | arrayrequiredВход

Строка или массив элементов входа.

instructionsstringИнструкции

Системная инструкция для модели.

max_output_tokensintegerЛимит ответа

Максимум токенов в ответе.

temperatureТемпература

Управляет случайностью выбора следующего токена. Значение около 0 делает ответы почти детерминированными и предсказуемыми — модель каждый раз выбирает наиболее вероятное продолжение. Более высокие значения (0.7–1.0 и выше) повышают разнообразие и «креативность», но и риск ошибок и бессвязности. Для фактических задач и кода обычно берут низкую температуру, для генерации идей и текстов — выше.

streambooleanСтриминг

Потоковый ответ (SSE).

toolsИнструменты

Описание набора функций (инструментов), которые модель может вызвать в ходе ответа. Для каждого инструмента передаётся имя, назначение и JSON-схема параметров. Модель сама решает, когда уместно вызвать инструмент, и возвращает имя функции с аргументами, а выполнение остаётся на стороне приложения. Это основа агентных сценариев и интеграций с внешними сервисами и данными.

Пример

curl https://api.aiadapter.ru/api/v1/responses \
  -H "Authorization: Bearer sk-aa-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-opus-4.8","input":"Привет!"}'

import requests

r = requests.post(
    "https://api.aiadapter.ru/api/v1/responses",
    headers={"Authorization": "Bearer sk-aa-v1-..."},
    json={
    "model": "anthropic/claude-opus-4.8",
    "input": "Привет!"
},
)
print(r.json())

const res = await fetch("https://api.aiadapter.ru/api/v1/responses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-aa-v1-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"model":"anthropic/claude-opus-4.8","input":"Привет!"}),
});
console.log(await res.json());

Ответ HTTP 200

{
  "id": "gen-resp012",
  "object": "response",
  "model": "anthropic/claude-opus-4.8",
  "output": [
    {
      "type": "message",
      "content": [
        {
          "type": "output_text",
          "text": "Привет! Чем помочь?"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 12,
    "cost_rub": 0.042
  }
}