Anthropic Messages

POST /v1/messages

Нативный формат обмена сообщениями Anthropic для моделей Claude. Модели Claude также можно вызывать через эндпоинт Chat Completions в формате OpenAI.

RequestREQUEST

POSThttps://test.kailin.com.cn/v1/messages

API KeyStored only in your browser, never uploaded

Body (JSON)SSE stream · rendered live{ "model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Hello, introduce yourself" } ], "stream": true }

ResponseRESPONSE

Fill in the request and hit Send — the response shows up here

Запрос

curl https://test.kailin.com.cn/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-token" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, introduce yourself" }
    ]
  }'

Примечание

Работают оба варианта заголовков: x-api-key: sk-xxx и Authorization: Bearer sk-xxx. Заголовок anthropic-version необязателен.

Тело запроса

Параметр	Тип	Обязательно	Описание
model	string	Да	Название модели Claude
max_tokens	number	Да	Максимум генерируемых токенов (обязателен в формате Anthropic)
messages	array	Да	Массив сообщений; role может быть только user / assistant
system	string / array	Нет	Системный промпт, передаётся отдельно от сообщений
stream	boolean	Нет	Потоковый вывод (SSE, типы событий ниже)
temperature	number	Нет	0–1, по умолчанию 1
top_p / top_k	number	Нет	Параметры сэмплирования
stop_sequences	array	Нет	Стоп-последовательности
tools	array	Нет	Определения инструментов (name / description / input_schema)
tool_choice	object	Нет	{"type": "auto"} / {"type": "any"} / {"type": "tool", "name": "..."}

Пример с системным промптом и изображением:

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a rigorous technical writer.",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "<base64>" } },
        { "type": "text", "text": "Describe this architecture diagram" }
      ]
    }
  ]
}

Ответ (без потоковой передачи)

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "Hello! I'm Claude…" }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 45
  }
}

Поле	Описание
content[]	Блоки контента — type может быть text / tool_use / thinking
stop_reason	end_turn / max_tokens / stop_sequence / tool_use
usage.input_tokens / output_tokens	Расход токенов

События потоковой передачи

При "stream": true ответ приходит по SSE с отдельными типами event::

event: message_start
data: {"type":"message_start","message":{...}}

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":"Hello"}}

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

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":45}}

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

Событие	Описание
message_start	Начало сообщения, с начальными данными об использовании
content_block_start / _delta / _stop	Начало / дельта / конец блока контента — дельты приходят в delta.text
message_delta	Обновление статуса верхнего уровня (stop_reason, финальное использование)
message_stop	Завершение сообщения
ping	Служебный heartbeat для поддержания соединения
error	Ошибка внутри потока

Использование Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-token",
    base_url="https://test.kailin.com.cn",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'sk-your-token',
  baseURL: 'https://test.kailin.com.cn',
});

const message = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello' }],
});
console.log(message.content[0].text);

Совет

Для SDK укажите в base_url корневой адрес (без /v1) — SDK автоматически добавит /v1/messages.