Anthropic Messages API

Anthropic-совместимый endpoint для сообщений и streaming

POST /v1/messages

Создать сообщение Anthropic Messages API

cURL

curl --request POST \
  --url https://speshu.ai/api/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --data '
{
  "model": "anthropic/claude-sonnet-4.6",
  "messages": [
    {
      "role": "user",
      "content": "Привет!"
    }
  ],
  "max_tokens": 1024,
  "stream": false,
  "temperature": 1,
  "top_p": 1,
  "top_k": 40,
  "stop_sequences": [
    "<string>"
  ],
  "system": "You are a helpful assistant.",
  "thinking": {
    "type": "adaptive"
  },
  "tools": [
    {}
  ],
  "tool_choice": {}
}
'

200

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Привет! Чем помочь?"
    }
  ],
  "model": "anthropic/claude-sonnet-4.6",
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 8
  }
}

SpeShu.AI поддерживает Anthropic-compatible POST /v1/messages. Если ваш клиент уже работает с Anthropic Messages API, замените base_url и используйте API-ключ SpeShu.AI.

​

Базовый URL

https://speshu.ai/api/v1

​

Авторизация

Поддерживаются оба варианта:

x-api-key: <SPESHU_AI_API_KEY>

Authorization: Bearer <SPESHU_AI_API_KEY>

Также передавайте версию API:

anthropic-version: 2023-06-01

​

Синхронный запрос

curl "https://speshu.ai/api/v1/messages" \
  -H "x-api-key: <SPESHU_AI_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Привет!" }
    ]
  }'

​

Ответ 200

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Привет! Чем помочь?"
    }
  ],
  "model": "anthropic/claude-sonnet-4.6",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 10,
    "output_tokens": 8
  }
}

​

Streaming

Установите stream: true, чтобы получать ответ через Server-Sent Events.

curl "https://speshu.ai/api/v1/messages" \
  -H "x-api-key: <SPESHU_AI_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Посчитай до 3" }
    ]
  }'

Ответ приходит как text/event-stream:

event: message_start
data: {"type":"message_start","message":{"id":"msg_abc","type":"message","role":"assistant","content":[],"model":"anthropic/claude-sonnet-4.6","stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":8,"output_tokens":1}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"1, 2, 3"}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"output_tokens":5}}

event: message_stop
data: {"type":"message_stop"}

Клиент должен корректно обрабатывать неизвестные event-типы. Anthropic может добавлять новые события без изменения основного контракта.

​

Параметры

Параметр	Тип	Обязательный	Описание
model	string	Да	ID модели. Например, anthropic/claude-sonnet-4.6.
messages	array	Да	История сообщений с role и content.
max_tokens	integer	Да	Максимум токенов в ответе.
stream	boolean	Нет	Включает SSE streaming. По умолчанию false.
temperature	number	Нет	Температура генерации.
top_p	number	Нет	Nucleus sampling.
top_k	integer	Нет	Top-K sampling.
stop_sequences	array	Нет	Пользовательские stop sequences.
system	string или array	Нет	Системная инструкция.
thinking	object	Нет	Настройки thinking. Например, { "type": "adaptive" }.
tools	array	Нет	Описание инструментов для tool use.
tool_choice	object	Нет	Стратегия выбора инструмента.

​

Python SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="<SPESHU_AI_API_KEY>",
    base_url="https://speshu.ai/api/v1",
)

message = client.messages.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)

print(message.content[0].text)

​

Ошибки

Ошибки возвращаются в Anthropic-style формате:

{
  "error": {
    "type": "api_error",
    "message": "model is required"
  }
}

HTTP status	Описание
400	Неверный JSON или параметры запроса.
401	API-ключ не передан или недействителен.
402	Недостаточно средств на балансе.
429	Превышен лимит запросов.
500	Внутренняя ошибка сервера.
502	Провайдер временно недоступен.

Авторизации

bearerxApiKey

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

API ключ передаётся в заголовке: Authorization: Bearer <SPESHU_AI_API_KEY>

Заголовки

anthropic-version · string · обязательно

Пример:

"2023-06-01"

Тело

application/json

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

Пример:

"anthropic/claude-sonnet-4.6"

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

Show child attributes

max_tokens · integer · обязательно

Пример:

1024

stream · boolean · по умолчанию: false

temperature · number

Пример:

1

top_p · number

Пример:

1

top_k · integer

Пример:

40

stop_sequences · string[]

system · string object[]

Пример:

"You are a helpful assistant."

thinking · object

Пример:

{ "type": "adaptive" }

tools · object[]

tool_choice · object

Ответ

200

application/json

Сообщение создано. При stream=true ответ приходит как text/event-stream.

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

Пример:

"msg_abc123"

type · string · обязательно

Пример:

"message"

role · string · обязательно

Пример:

"assistant"

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

Show child attributes

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

Пример:

"anthropic/claude-sonnet-4.6"

stop_reason · string | null

Пример:

"end_turn"

stop_sequence · string | null

usage · object

Show child attributes