# Claude Sonnet 4.5

> Популярная модель Anthropic Claude Sonnet 4.5: тексты, код, анализ документов. Можно приложить изображения.

Claude Sonnet 4.5 — проверенная модель Anthropic для текстов, программирования и анализа документов и изображений. Задача асинхронная: ответ появляется в `resultJson.text`. Оплата по фактическим токенам. Промпт до 30 000 символов, до 10 изображений во вложении.


### Вопрос или задача текстом — модель ответит текстом. Картинки в `input_urls` — по желанию.

ID: `claude-sonnet-4.5` · $1.445 / 1M вход · $7.2675 / 1M выход (~129 ₽ / ~651 ₽) · в среднем ~29 сек

Семейство Claude Sonnet, версия 4.5. Другие версии: `claude-sonnet-5.5` (5.5). У каждой версии свой ID модели.

**Параметры** (поле `input`)

| Параметр | Обязательный | Описание | Значения (по умолчанию — жирным) |
|---|---|---|---|
| `prompt` | да | Ваш вопрос или задача | текст, до 30000 символов |
| `input_urls` | нет | Картинки для анализа (https-ссылки), до 10 шт.; каждая — 560 входных токенов | `["https://…"]` |
| `reasoning` | нет | Уровень рассуждений (по умолчанию `medium`): `none`/`off` — отвечает сразу, `low` — быстро, `medium` — сбалансированно, `high` — глубже и дольше, `xhigh` — максимум (где есть). Цена за токен не меняется; токены рассуждений входят в выход и оплачиваются | `off` `low` **`medium`** `high` |
| `system_prompt` | нет | Инструкция для модели (роль, стиль, правила), до 10 000 символов |  |
| `messages` | нет | История диалога: `[{"role":"user","content":"…"},{"role":"assistant","content":"…"}]` — по очереди, с `user`, последним — `assistant`; новый вопрос — в `prompt`. До 40 сообщений, 60 000 символов, считаются входными токенами | `[{role, content}]` |
| `response_format` | нет | `json` — ответ одним валидным JSON-объектом | **`text`** `json` |

**Пример**

```bash
curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4.5","input":{"prompt":"Объясни простыми словами, почему небо голубое","reasoning":"medium","response_format":"text"}}'
```

```python
import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "claude-sonnet-4.5",
      "input": {
        "prompt": "Объясни простыми словами, почему небо голубое",
        "reasoning": "medium",
        "response_format": "text"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "claude-sonnet-4.5",
    "input": {
      "prompt": "Объясни простыми словами, почему небо голубое",
      "reasoning": "medium",
      "response_format": "text"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Цена: оплата по токенам

| Вход, за 1M токенов | Выход, за 1M токенов (включая рассуждения) |
|---|---|
| $1.445 | $7.2675 |


**В среднем запрос ~$0.0036 (~0,3 ₽) — короткий вопрос, ответ на страницу или вопрос с фото. Цена зависит от длины: чем меньше слов и фото, тем дешевле.**

- **Токены — фактические**: их считает сама модель. Входные = промпт, инструкция и картинки; выходные = ответ вместе с рассуждениями модели.
- Стоимость = входные × цена входа / 1M + выходные × цена выхода / 1M, округление вверх до $0.0001.
- При создании задачи резервируется сумма на ваш вопрос и до 16 384 выходных токенов (ответ дороже резерва не бывает). Когда ответ готов, списывается фактическая сумма, остаток сразу возвращается на баланс. Ошибка — возврат всего резерва.
- В ответе `recordInfo` и в колбэке — `usage`: `input_tokens`, `output_tokens`, `total_tokens`, `cost` (USD), `estimated: false`.

Пример: вопрос 400 символов (100 токенов) и ответ 4 000 символов (1 000 токенов) = 100 × $1.445/1M + 1 000 × $7.2675/1M = $0.0075.

## Результат

Как у любой задачи: запросите [recordInfo](https://docs.mixmedia.tech/endpoints/record-info) или получите [callback](https://docs.mixmedia.tech/callbacks). Ответ — в `resultJson.text`, расход токенов и списание — в `usage` (`input_tokens`, `output_tokens`, `cost`).



Свои фото загрузите через [files/upload](https://docs.mixmedia.tech/endpoints/upload) или передайте любые публичные https-ссылки.

## Обработка ошибок

Ответ API — JSON `{"code", "msg", "data"}`; при ошибке есть строковое поле `error` (тип). **На `/api/v1/*` HTTP-статус совпадает с `code` в теле.**

### Примеры тел ответа

**400**

```json
{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}
```

**401**

```json
{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}
```

**402**

```json
{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://mixmedia.tech/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}
```

**429**

```json
{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}
```

**500**

```json
{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}
```

### Коды при createTask / upload

| code | error | Что значит | Что делать |
|---|---|---|---|
| 400 | `invalid_request_error` | Неверный параметр или тело | Смотрите `msg` |
| 400 | `unsupported_model` | Нет такой модели | [Список моделей](https://docs.mixmedia.tech/models) |
| 401 | `authentication_error` | Нет ключа или он неверный | Проверьте ключ |
| 402 | `payment_required` | Не хватает денег | Пополните баланс |
| 403 | `permission_error` | Нет доступа | Напишите в поддержку |
| 429 | `rate_limit_error` | Слишком много запросов | Подождите `Retry-After` |
| 505 | `model_disabled` | Модель временно отключена | Выберите другую |
| 500 | `server_error` | Сбой у нас | Повторите позже |

Примеры `msg`: `Authentication failed. Please check your API key` (401); `Insufficient balance. Please top up and try again…` (402).

### Ошибки задачи (recordInfo)

Если задача уже создана и завершилась неудачей: `state: "fail"` (алиас `status: "failed"`), `failCode` / `failMsg`, объект `error: { code, message, type }`. Деньги возвращаются (`refunded: true`).

| failCode | error.type | Что значит |
|---|---|---|
| 400 | `nsfw_content_detected` / `invalid_request_error` | Модерация — `failMsg` = текст upstream как есть |
| 422 | `invalid_request_error` | Модель не приняла параметры (например, не скачалось фото) |
| 501 | `server_error` | Модель не смогла сгенерировать (`failMsg`) |
| 504 | `timeout_error` | Слишком долго — повторите |
| 500 / 503 | `server_error` | Сервис временно недоступен |

### Лимиты запросов

| Что | Лимит |
|---|---|
| createTask и upload | 20 за 10 с на ключ |
| recordInfo / list / balance | 100 за 10 с на ключ |

Сверх лимита — HTTP 429 и `Retry-After`.