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

POST/messages

Эндпоинт в формате Anthropic Messages. Удобно, если у вас уже есть код под Anthropic SDK — поменяйте base URL и ключ.

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

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

modelstringrequiredМодель

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

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

Максимум токенов в ответе (в Anthropic-формате обязателен).

messagesarrayrequiredСообщения

Массив сообщений {"role","content"}.

systemstringСистемный промпт

Системная инструкция (отдельным полем, а не сообщением).

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

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

streambooleanСтриминг

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

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

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

Пример

curl https://api.aiadapter.ru/api/v1/messages \
  -H "Authorization: Bearer sk-aa-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-opus-4.8","max_tokens":1024,"messages":[{"role":"user","content":"Привет!"}]}'

import requests

r = requests.post(
    "https://api.aiadapter.ru/api/v1/messages",
    headers={"Authorization": "Bearer sk-aa-v1-..."},
    json={
    "model": "anthropic/claude-opus-4.8",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Привет!"
        }
    ]
},
)
print(r.json())

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

Ответ HTTP 200

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