ДокументацияСправочник APIMessages API

Messages API

Совместимый с Anthropic эндпоинт Messages и count_tokens.

POST/v1/messages

Чат-эндпоинт, совместимый с телом запроса Anthropic Messages API. Аутентификация через x-api-key (или Authorization: Bearer); заголовки, добавляемые SDK автоматически (например, anthropic-version), пересылаются без изменений.

Тело запроса

ПолеТипОбязательноеОписание
modelstringДаИдентификатор модели — см. Модели.
max_tokensintegerДаЛимит выходных токенов (в формате Anthropic обязателен).
messagesarrayДаСообщения диалога; role — user/assistant, content — строка или массив блоков (допустимы изображения).
systemstring | arrayНетСистемный промпт.
streambooleanНетПри true ответ передаётся потоком SSE — см. Стриминг.
temperature / tools / …—НетОстальные официальные поля пересылаются как есть; поддержка зависит от целевой модели.
request.sh
curl https://api.soleapi.com/v1/messages \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

Ответ

response.json
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5",
  "content": [
    { "type": "text", "text": "Waves fold into foam..." }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 23 }
}

Подсчёт токенов

POST/v1/messages/count_tokens

Оценивает число входных токенов до отправки; тело запроса совпадает с Messages (без max_tokens). Сам подсчёт не тарифицируется как вызов модели.

count_tokens.sh
curl https://api.soleapi.com/v1/messages/count_tokens \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

# => { "input_tokens": 14 }