> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Muse Messages

POST https://direct.beatapi.io/v1/messages
Content-Type: application/json

Вызывайте Muse Wonder в формате Anthropic Messages с ключом BeatAPI.- Muse Wonder доступна через `POST /v1/messages`.
- Потоковая передача, вызовы инструментов и контекстное окно на 1M токенов.
- Совместимо с Anthropic SDK: измените базовый URL и используйте ключ BeatAPI. Передавайте заголовок `anthropic-version` с каждым запросом.
- `tool_choice` передаётся модели, но не каждая модель его соблюдает; `thinking` не влияет на результат. См. описание параметров ниже.Для текстовых запросов используйте базовый URL `https://direct.beatapi.io`. Этот адрес не ограничен 100-секундным тайм-аутом Cloudflare, который может прервать долгий запрос без потоковой передачи. Если ваша сеть не может подключиться к нему, используйте `https://api.beatapi.io`. Ключи, модели и цены одинаковы. API изображений и видео используют только `https://api.beatapi.io`.POST/v1/messagesПопробоватьОткрывает эндпоинт в API Explorer. Если ввести ключ BeatAPI и отправить запрос, будет выполнен реальный вызов с оплатой из вашего баланса.## МоделиПередайте этот ID в `model`.| ID модели     | Контекст (токены) | Максимальный вывод (токены) | Назначение                                                                                             | Ввод, USD за миллион токенов | Вывод, USD за миллион токенов | Примечания                                                                                                                |
| ------------- | ----------------- | --------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `muse-wonder` | 1 048 576         | 131 072                     | Meta Muse Wonder: передовая модель с рассуждениями для сложных личных и профессиональных задач агентов | \$4.00                       | \$20.00                       | Передовая модель Meta с рассуждениями для сложных личных и профессиональных задач агентов. Требуется пополненный аккаунт. |- Указаны базовые цены со скидкой. Не включены тарифы для длинного контекста, кэшированного ввода и записи в кэш. См. [страницу цен](https://beatapi.io/pricing).
- `—` означает, что каталог не публикует это значение.## Быстрый стартУстановите пакет `@anthropic-ai/sdk` или `anthropic` на сервере и сохраните ключ в `BEATAPI_API_KEY`. Не помещайте ключ в код браузерного приложения. SDK сам отправляет заголовок `anthropic-version`. Ниже показаны примеры запросов, а не записанные ответы модели.Прочитайте ответ в блоках `text` массива `content`, затем проверьте `stop_reason` и `usage`. Сам по себе HTTP 200 не означает, что ответ решает вашу задачу: проверяйте результат в приложении. Текстовые запросы возвращают ответ напрямую; опрашивать `/v1/tasks` для них не нужно.```bash title="cURL"
curl --request POST \
  --url https://direct.beatapi.io/v1/messages \
  --header "x-api-key: $BEATAPI_API_KEY" \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "muse-wonder",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
``````python title="Python"
import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["BEATAPI_API_KEY"], base_url="https://direct.beatapi.io")
message = client.messages.create(
    model="muse-wonder",
    max_tokens=2000,
    messages=[
      {
        "role": "user",
        "content": "Design a resilient webhook retry strategy for a payments API."
      }
    ],
)
print(message.content[0].text)
``````javascript title="JavaScript"
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ apiKey: process.env.BEATAPI_API_KEY, baseURL: "https://direct.beatapi.io" });
const message = await client.messages.create({
  "model": "muse-wonder",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
});
console.log(message.content[0].text);
```## Эндпоинт и аутентификация`POST https://direct.beatapi.io/v1/messages`x-api-key
string
ОбязательноИспользуйте ключ BeatAPI. Также поддерживается `Authorization: Bearer <BEATAPI_API_KEY>`.Передавайте заголовок `anthropic-version` (например, `2023-06-01`) с каждым запросом; Anthropic SDK добавляет его автоматически. Для авторизации подходят и `x-api-key`, и `Authorization: Bearer <BEATAPI_API_KEY>`.## Параметры запросаЗапрос имеет формат Anthropic Messages. Ниже описано действие каждого поля; `thinking` принимается, но не меняет результат. Действие полей, не описанных на этой странице, не гарантируется.model
string
ОбязательноТочный ID модели.**Допустимые значения**: `muse-wonder`- Каждый ID обозначает отдельную модель, а не псевдоним другой модели.
- Вызовите `GET /v1/models` со своим ключом, чтобы проверить, какие модели ему доступны.max_tokens
integer
ОбязательноМаксимальное число генерируемых токенов, включая токены рассуждений.- Шлюз не сравнивает указанное значение с максимальным объёмом вывода модели из таблицы выше. Не превышайте этот предел.
- `max_tokens` также используется для оценки необходимого баланса. Слишком большое значение может привести к `402 insufficient_credits`, даже если фактический ответ был бы коротким. Указывайте столько токенов, сколько требуется задаче.Модель с рассуждениями сначала генерирует рассуждения. Если `max_tokens` слишком мал, весь лимит может быть потрачен на них: блок `text` окажется пустым, а `stop_reason` будет равен `max_tokens`. Оставляйте запас и для рассуждений, и для ответа. При таком `stop_reason` увеличьте лимит.messages
object[]
ОбязательноИстория диалога, от самого раннего сообщения к последнему. У каждого сообщения есть `role` (`user` или `assistant`) и `content`: строка либо массив блоков.- Обрабатываются текстовые блоки (`text`), запросы модели на вызов инструментов (`tool_use`) и ваши результаты (`tool_result`).
- В блоке `tool_result` должен быть указан `tool_use_id` того блока `tool_use`, на который он отвечает.system
string | object[]
НеобязательноСистемный промпт: строка либо массив текстовых блоков. Текстовые блоки объединяются в один системный промпт.stream
boolean
НеобязательноПо умолчанию: falseПередавать ответ потоком событий SSE. См. раздел о потоковой передаче ниже.**По умолчанию**: `false`temperature
number
НеобязательноТемпература семплирования. Меняйте либо этот параметр, либо `top_p`, но не оба одновременно.top_p
number
НеобязательноПорог суммарной вероятности для выборки (nucleus sampling).stop_sequences
string[]
НеобязательноПоследовательности, при которых генерация останавливается.tools
object[]
НеобязательноОпределения инструментов, которые может вызвать модель. Для каждого инструмента используются `name`, `description` и `input_schema`. Модель возвращает блок `tool_use`; передайте результат в блоке `tool_result` следующего сообщения `user`.tool_choice
object
НеобязательноУправляет использованием `tools`: `{"type": "auto"}` оставляет выбор модели (по умолчанию), `{"type": "any"}` требует вызвать один из инструментов, `{"type": "tool", "name": "..."}` — указанный инструмент, а `{"type": "none"}` запрещает вызовы. `disable_parallel_tool_use: true` ограничивает ответ одним вызовом. Без `tools` параметр игнорируется. Настройка передаётся модели, но не каждая модель её соблюдает: в наших тестах от 2026-10-15 DeepSeek игнорировал её, а Qwen выполнял `any`, но не требование вызвать инструмент по имени. Поэтому проверяйте наличие `tool_use` в ответе, а не предполагайте, что инструмент обязательно вызван.thinking
object
НеобязательноНе влияет на результат: не включает и не отключает рассуждения и не задаёт их бюджет. Модель, которая рассуждает по умолчанию, продолжает это делать и возвращает рассуждения в блоках `thinking`.## ОтветБез потоковой передачи запрос возвращает один JSON-объект. Ниже приведён сокращённый пример.```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "muse-wonder",
  "content": [
    {
      "type": "text",
      "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16
  }
}
```### Поля ответа| Поле             | Тип        | Описание                                                                                                                                                                  |
| ---------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`             | `string`   | ID сообщения. Сохраняйте его вместе с ID запроса для обращений в поддержку и сверки расходов.                                                                             |
| `model`          | `string`   | Модель, сформировавшая ответ.                                                                                                                                             |
| `content[]`      | `object[]` | Блоки содержимого: `thinking` (у моделей с рассуждениями, перед ответом), `text` и `tool_use`.                                                                            |
| `content[].text` | `string`   | Текст ответа из блока `text`.                                                                                                                                             |
| `stop_reason`    | `string`   | `end_turn` — ответ завершён; `tool_use` — запрошен инструмент; `max_tokens` — достигнут лимит `max_tokens`; `stop_sequence` — найдена останавливающая последовательность. |
| `usage`          | `object`   | `input_tokens` и `output_tokens`. Рассуждения учитываются как выходные токены. Стоимость рассчитывается по фактическому использованию токенов.                            |## Потоковая передачаУстановите `"stream": true`. Поток начинается с `message_start` и заканчивается `message_stop`. Блоки между ними передаются событиями `content_block_start`, `content_block_delta` и `content_block_stop`; событие `message_delta` содержит `stop_reason`.- Тип ответа — `text/event-stream`; без потоковой передачи — `application/json`.
- Текст поступает событиями `text_delta`. Модель с рассуждениями перед текстом отправляет блок `thinking` с событиями `thinking_delta`. Аргументы инструментов поступают событиями `input_json_delta`.
- Ошибка до вызова модели возвращается обычным JSON-ответом с HTTP-кодом, а не событием потока.
- Явно задайте тайм-ауты и предусмотрите безопасное восстановление соединения при потоковой передаче.```text
event: message_start
data: {"type":"message_start","message":{"id":"msg_example","type":"message","role":"assistant","content":[],"usage":{"input_tokens":19,"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":"Retry"}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":" with backoff"}}

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

event: message_stop
data: {"type":"message_stop"}
```## Устранение ошибок| Ошибка или симптом                                     | Причина                                                                                                              | Решение                                                                                       |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Блок `text` пустой, а `stop_reason` равен `max_tokens` | Модель потратила весь лимит `max_tokens` на рассуждения.                                                             | Увеличьте `max_tokens`, не превышая максимальный объём вывода модели.                         |
| `402 insufficient_credits`                             | Баланс меньше оценочной стоимости запроса, часто из-за слишком большого `max_tokens`.                                | Пополните баланс или уменьшите `max_tokens`.                                                  |
| `403 forbidden`                                        | На аккаунте только регистрационный бонус, а модель не входит в разрешённый список, либо она недоступна группе ключа. | Пополните баланс, выберите бесплатную модель или используйте ключ с доступом к нужной модели. |
| `404 not_found`                                        | Неизвестный ID модели либо модель недоступна этому ключу.                                                            | Получите список доступных моделей через `GET /v1/models`.                                     |
| `429 rate_limit_exceeded`                              | Достигнут лимит запросов аккаунта или бесплатной модели.                                                             | Подождите время, указанное в `Retry-After`, затем повторите запрос.                           |### Обзор HTTP-ошибокОшибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).| HTTP-статус | Коды                                                       | Что делать                                                                                                         |
| ----------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 400         | `bad_request`, `content_policy_violation`                  | Исправьте запрос или ввод. Не отправляйте его повторно без изменений.                                              |
| 401         | `missing_api_key`, `invalid_api_key`                       | Проверьте ключ. Не повторяйте запрос без исправления.                                                              |
| 402         | `insufficient_credits`                                     | Пополните баланс или увеличьте лимит ключа. Слишком высокий `max_tokens` может вызвать эту ошибку.                 |
| 403         | `forbidden`                                                | Проверьте группу ключа, список разрешённых IP и доступность модели за бесплатные кредиты.                          |
| 404         | `not_found`                                                | Неизвестная модель. Проверьте активные модели через `GET /v1/models`.                                              |
| 429         | `rate_limit_exceeded`                                      | Подождите согласно `Retry-After` или `retry_after_seconds`, затем повторите запрос с увеличивающимися интервалами. |
| 500         | `internal_error`, `temporary_error`                        | Повторите запрос один-два раза с увеличивающимися интервалами.                                                     |
| 503         | `model_unavailable`, `upstream_timeout`, `temporary_error` | Повторите запрос с увеличивающимися интервалами или выберите другую модель.                                        |Все коды и правила повторных запросов: [ошибки](/errors#text-endpoints).## Примечания- Muse также доступна через [Chat Completions](/text-api/muse/chat-completions) и [OpenAI Responses](/text-api/muse/responses).
- Для `muse-wonder` требуется пополненный аккаунт. Аккаунт только с регистрационным бонусом не может вызывать эту модель.
- Muse Wonder рассуждает перед ответом. Токены рассуждений входят в выходные токены и оплачиваются как вывод.
- Передавайте `anthropic-version` с каждым запросом. Не полагайтесь на `thinking`: этот параметр не влияет на результат.
- Храните ключи на доверенных серверах, записывайте ID запроса из ответа и повторяйте запросы только при ошибках `429`, `500` и `503`.

Reference: https://docs.beatapi.io/api-reference/text-api/muse-messages

## Authentication

- `Authorization` header (bearer token, required) — Передавайте API-ключ в виде `Authorization: Bearer <BEATAPI_API_KEY>`.

## Servers

- `https://direct.beatapi.io` (Direct, default)
- `https://api.beatapi.io` (API)

## Request

### Body (application/json)

This endpoint expects an object.

- `model` (enum, required) — Точный ID модели. Каждый ID обозначает отдельную модель, а не псевдоним другой модели. Вызовите `GET /v1/models` со своим ключом, чтобы проверить, какие модели ему доступны. `muse-wonder`
  - Allowed values: `muse-wonder`
- `max_tokens` (integer, required) — Максимальное число генерируемых токенов, включая токены рассуждений. Шлюз не сравнивает указанное значение с максимальным объёмом вывода модели из таблицы выше. Не превышайте этот предел. `max_tokens` также используется для оценки необходимого баланса. Слишком большое значение может привести к `402 insufficient_credits`, даже если фактический ответ был бы коротким. Указывайте столько токенов, сколько требуется задаче. Модель с рассуждениями сначала генерирует рассуждения. Если `max_tokens` слишком мал, весь лимит может быть потрачен на них: блок `text` окажется пустым, а `stop_reason` будет равен `max_tokens`. Оставляйте запас и для рассуждений, и для ответа. При таком `stop_reason` увеличьте лимит.
- `messages` (list of V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItems, required) — История диалога, от самого раннего сообщения к последнему. У каждого сообщения есть `role` (`user` или `assistant`) и `content`: строка либо массив блоков. Обрабатываются текстовые блоки (`text`), запросы модели на вызов инструментов (`tool_use`) и ваши результаты (`tool_result`). В блоке `tool_result` должен быть указан `tool_use_id` того блока `tool_use`, на который он отвечает.
- `system` (V1MessagesPostRequestBodyContentApplicationJsonSchemaSystem, optional) — Системный промпт: строка либо массив текстовых блоков. Текстовые блоки объединяются в один системный промпт.
- `stream` (boolean, optional, default: false) — Передавать ответ потоком событий SSE. См. раздел о потоковой передаче ниже.
- `temperature` (double, optional) — Температура семплирования. Меняйте либо этот параметр, либо `top_p`, но не оба одновременно.
- `top_p` (double, optional) — Порог суммарной вероятности для выборки (nucleus sampling).
- `stop_sequences` (list of string, optional) — Последовательности, при которых генерация останавливается.
- `tools` (list of V1MessagesPostRequestBodyContentApplicationJsonSchemaToolsItems, optional) — Определения инструментов, которые может вызвать модель. Для каждого инструмента используются `name`, `description` и `input_schema`. Модель возвращает блок `tool_use`; передайте результат в блоке `tool_result` следующего сообщения `user`.
- `tool_choice` (V1MessagesPostRequestBodyContentApplicationJsonSchemaToolChoice, optional) — Управляет использованием `tools`: `{"type": "auto"}` оставляет выбор модели (по умолчанию), `{"type": "any"}` требует вызвать один из инструментов, `{"type": "tool", "name": "..."}` — указанный инструмент, а `{"type": "none"}` запрещает вызовы. `disable_parallel_tool_use: true` ограничивает ответ одним вызовом. Без `tools` параметр игнорируется. Настройка передаётся модели, но не каждая модель её соблюдает: в наших тестах от 2026-10-15 DeepSeek игнорировал её, а Qwen выполнял `any`, но не требование вызвать инструмент по имени. Поэтому проверяйте наличие `tool_use` в ответе, а не предполагайте, что инструмент обязательно вызван.
- `thinking` (V1MessagesPostRequestBodyContentApplicationJsonSchemaThinking, optional) — Не влияет на результат: не включает и не отключает рассуждения и не задаёт их бюджет. Модель, которая рассуждает по умолчанию, продолжает это делать и возвращает рассуждения в блоках `thinking`.

## Response

### 200

Без потоковой передачи запрос возвращает один JSON-объект. Ниже приведён сокращённый пример.

- `id` (string, optional) — ID сообщения. Сохраняйте его вместе с ID запроса для обращений в поддержку и сверки расходов.
- `model` (string, optional) — Модель, сформировавшая ответ.
- `content` (list of V1MessagesPostResponsesContentApplicationJsonSchemaContentItems, optional) — Блоки содержимого: `thinking` (у моделей с рассуждениями, перед ответом), `text` и `tool_use`.
- `stop_reason` (string, optional) — `end_turn` — ответ завершён; `tool_use` — запрошен инструмент; `max_tokens` — достигнут лимит `max_tokens`; `stop_sequence` — найдена останавливающая последовательность.
- `usage` (V1MessagesPostResponsesContentApplicationJsonSchemaUsage, optional) — `input_tokens` и `output_tokens`. Рассуждения учитываются как выходные токены. Стоимость рассчитывается по фактическому использованию токенов.

## Errors

### 400 Bad Request Error

`bad_request`, `content_policy_violation` Исправьте запрос или ввод. Не отправляйте его повторно без изменений. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 401 Unauthorized Error

`missing_api_key`, `invalid_api_key` Проверьте ключ. Не повторяйте запрос без исправления. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 402 Payment Required Error

`insufficient_credits` Пополните баланс или увеличьте лимит ключа. Слишком высокий `max_tokens` может вызвать эту ошибку. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 403 Forbidden Error

`forbidden` Проверьте группу ключа, список разрешённых IP и доступность модели за бесплатные кредиты. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 404 Not Found Error

`not_found` Неизвестная модель. Проверьте активные модели через `GET /v1/models`. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 429 Too Many Requests Error

`rate_limit_exceeded` Подождите согласно `Retry-After` или `retry_after_seconds`, затем повторите запрос с увеличивающимися интервалами. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 500 Internal Server Error

`internal_error`, `temporary_error` Повторите запрос один-два раза с увеличивающимися интервалами. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

### 503 Service Unavailable Error

`model_unavailable`, `upstream_timeout`, `temporary_error` Повторите запрос с увеличивающимися интервалами или выберите другую модель. Ошибки до вызова модели используют поля BeatAPI `error.code`, `error.message`, `retryable` и `request_id`. Остальные сохраняют формат Anthropic `{"type": "error", "error": {"type", "message"}}`. Код находится в `error.type`, ID запроса — в конце `message`. См. [ошибки](/errors#text-endpoints).

- `map from string to any`

## Types

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItems

- `role` (string, required)
- `content` (V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent, required)

### V1MessagesPostRequestBodyContentApplicationJsonSchemaSystem

Системный промпт: строка либо массив текстовых блоков. Текстовые блоки объединяются в один системный промпт.

- string
- list of V1MessagesPostRequestBodyContentApplicationJsonSchemaSystemOneOf1Items

### V1MessagesPostRequestBodyContentApplicationJsonSchemaToolsItems

### V1MessagesPostRequestBodyContentApplicationJsonSchemaToolChoice

Управляет использованием `tools`: `{"type": "auto"}` оставляет выбор модели (по умолчанию), `{"type": "any"}` требует вызвать один из инструментов, `{"type": "tool", "name": "..."}` — указанный инструмент, а `{"type": "none"}` запрещает вызовы. `disable_parallel_tool_use: true` ограничивает ответ одним вызовом. Без `tools` параметр игнорируется. Настройка передаётся модели, но не каждая модель её соблюдает: в наших тестах от 2026-10-15 DeepSeek игнорировал её, а Qwen выполнял `any`, но не требование вызвать инструмент по имени. Поэтому проверяйте наличие `tool_use` в ответе, а не предполагайте, что инструмент обязательно вызван.

### V1MessagesPostRequestBodyContentApplicationJsonSchemaThinking

Не влияет на результат: не включает и не отключает рассуждения и не задаёт их бюджет. Модель, которая рассуждает по умолчанию, продолжает это делать и возвращает рассуждения в блоках `thinking`.

### V1MessagesPostResponsesContentApplicationJsonSchemaContentItems

- `text` (string, optional) — Текст ответа из блока `text`.

### V1MessagesPostResponsesContentApplicationJsonSchemaUsage

`input_tokens` и `output_tokens`. Рассуждения учитываются как выходные токены. Стоимость рассчитывается по фактическому использованию токенов.

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContent

- string
- list of V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items

### V1MessagesPostRequestBodyContentApplicationJsonSchemaSystemOneOf1Items

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1Items

- `type` (string, optional)
- `text` (string, optional)
- `image_url` (V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsImageUrl, optional)
- `source` (V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsSource, optional)

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsImageUrl

- string
- V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsImageUrl1

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsSource

- `type` (string, optional)
- `media_type` (string, optional)
- `data` (string, optional)
- `url` (string, optional)

### V1MessagesPostRequestBodyContentApplicationJsonSchemaMessagesItemsContentOneOf1ItemsImageUrl1

- `url` (string, optional)
- `detail` (string, optional)

## Examples

**Request**

```json
{
  "model": "muse-wonder",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}
```

**Response**

```json
{
  "id": "msg_example",
  "model": "muse-wonder",
  "content": [
    {
      "text": "Retry with exponential backoff and jitter, and make every handler idempotent.",
      "type": "text"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16
  },
  "role": "assistant",
  "stop_sequence": null,
  "type": "message"
}
```

**SDK Code**

```python Быстрый старт
import requests

url = "https://direct.beatapi.io/v1/messages"

payload = {
    "model": "muse-wonder",
    "max_tokens": 2000,
    "messages": [
        {
            "role": "user",
            "content": "Design a resilient webhook retry strategy for a payments API."
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Быстрый старт
const url = 'https://direct.beatapi.io/v1/messages';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"model":"muse-wonder","max_tokens":2000,"messages":[{"role":"user","content":"Design a resilient webhook retry strategy for a payments API."}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Быстрый старт
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://direct.beatapi.io/v1/messages"

	payload := strings.NewReader("{\n  \"model\": \"muse-wonder\",\n  \"max_tokens\": 2000,\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Design a resilient webhook retry strategy for a payments API.\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Быстрый старт
require 'uri'
require 'net/http'

url = URI("https://direct.beatapi.io/v1/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"muse-wonder\",\n  \"max_tokens\": 2000,\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Design a resilient webhook retry strategy for a payments API.\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
```

```java Быстрый старт
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://direct.beatapi.io/v1/messages")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"muse-wonder\",\n  \"max_tokens\": 2000,\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Design a resilient webhook retry strategy for a payments API.\"\n    }\n  ]\n}")
  .asString();
```

```php Быстрый старт
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://direct.beatapi.io/v1/messages', [
  'body' => '{
  "model": "muse-wonder",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Быстрый старт
using RestSharp;

var client = new RestClient("https://direct.beatapi.io/v1/messages");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"model\": \"muse-wonder\",\n  \"max_tokens\": 2000,\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Design a resilient webhook retry strategy for a payments API.\"\n    }\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Быстрый старт
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "model": "muse-wonder",
  "max_tokens": 2000,
  "messages": [
    [
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    ]
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://direct.beatapi.io/v1/messages")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```