# MAI Transcribe 2 — транскрибация, Microsoft, через API СОЮЗа

> Идентификатор для поля `model`: `mai-transcribe-2`. Страница: https://souz.ai/models/mai-transcribe-2. Звук → Текст. Выпущена 17 июня 2026.

СОЮЗ — единый API к нейросетям разных вендоров: один ключ, общий баланс в рублях, списание только за успешный запрос. Эта модель вызывается по контракту ниже.

MAI Transcribe 2 — разбирает речь на фоне шума и сложные термины. Для совещаний, интервью и разговоров с клиентами.

## Цены

Неуспешный запрос не тарифицируется. В ответах API итог — `price` у задачи и `usage.cost` у чата — целые микроединицы валюты платформы (1 единица = 1 000 000 микро), а сама валюта приезжает рядом полем `currency` (сейчас `RUB`). У незавершённой задачи `price: null`.

- Секунда аудио — 0,003991 ₽ за секунду

Цены и типичное время пресетов роутинга — поле `routing`: `cheap` «Дешевле», `balanced` «Баланс» (по умолчанию), `fast` «Быстрее». Пресет задаёт порядок каналов; где пресеты начинают с одного канала, цена у них общая. Потолок `max_price_multiplier` (`1.5`, `2`, `3`, `5`, `10`) не даёт пробовать каналы дороже цены пресета больше чем во столько раз.

- Цена по каналам: Красный (`red`) — 0,003991 ₽ за секунду.

Цена не зависит от канала; скорость и стабильность каждого — в блоке «Каналы».

## Каналы

Канал — постоянный цвет внутри модели: у каждого свои ставки, задержка, скорость и стабильность. Цвет не означает «дешёвый» или «быстрый», одинаковый цвет у другой модели — другой канал. Задержка и скорость — медиана за последний час, стабильность — доля успешных вызовов за 7 дней; «нет данных» — замеров пока мало, а не ноль.

Каналов: 1. Данные на момент сборки страницы; свежие — `GET https://api.souz.ai/v1/models/mai-transcribe-2/channels` без ключа (там же HEX цвета, пределы входа и p90).

| Канал (`id`) | Название | Доступен | Ставки | Время ответа, p50 за сутки | Стабильность, 7 дней |
| --- | --- | --- | --- | --- | --- |
| `red` | Красный | да | 0,003991 ₽ за секунду | 0,7 с | нет данных |

Как выбрать канал:

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["red"]}` — только этот канал, без запасных; `{"order": ["red"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `{"sort": "price"}` (`latency`) — порядок по критерию вместо пресета; `max_price` — пределы ставок. SDK OpenAI — через `extra_body`, в форме транскрибации — JSON-строкой.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/mai-transcribe-2/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`) и оценка `estimated_price`; пустой `channels` — с такими условиями запрос не выполнить.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"mai-transcribe-2": {"only": ["red"]}}}`. PATCH заменяет всю карту — сначала прочитайте `GET https://api.souz.ai/v1/settings` и сохраните настройки других моделей. Запрос без `routing_options` наследует настройку; `{}` в запросе — автоматический выбор на один вызов.
- MCP: https://api.souz.ai/mcp — инструменты `list_channels`, `compare_channels`, `preview_routing`, `pin_channel`, `unpin_channel`. Подключение в Claude Code: `claude mcp add --transport http souz https://api.souz.ai/mcp --header "Authorization: Bearer $SOUZ_API_KEY"`.
- Каким каналом выполнен запрос — поле `channel` в ответе (у чата — и в каждом чанке потока), в задаче, вебхуке и истории запросов; `attempt_count` — сколько было попыток.

## Подключение по API

- Адрес: `POST https://api.souz.ai/v1/audio/transcriptions`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — `multipart/form-data`: `file`, поле `model` — `mai-transcribe-2`, необязательные `language` (ISO 639-1) и `response_format`.
- Ответ приходит сразу — объект задачи: расшифровка `text`, `usage.characters` и итог `price`. `response_format`: `json` (по умолчанию), `verbose_json` (ещё `language`, `duration` и фразы `segments` с таймкодами; слова `words` — с `timestamp_granularities[]=word`), `text` (только текст, id задачи — в заголовке `X-Job-Id`), `srt` (субтитры по тем же фразам, id задачи — в заголовке `X-Job-Id`). Язык `language` — код ISO 639-1 (`ru`, `en`) и в запросе, и в ответе. Не успела за 9 минут — `202` и `GET https://api.souz.ai/v1/jobs/{id}`.
- Ошибки — JSON вида `{ "error": { "type", "code", "message", "detail" } }` с кодом HTTP 4xx/5xx; ветвиться — по `type` и `code`. `401` — неверный ключ; `402` с кодом `insufficient_balance` — не хватает средств на балансе, `key_spend_limit_exceeded` или `member_spend_limit_exceeded` — исчерпан лимит трат ключа или участника, повтор не поможет; `400` с кодом `capability_mismatch` или `invalid_request` — запрос не подходит модели, в `error.detail[]` — поле (`path`), причина (`reason`) и что подойдёт (`allowed`); `503 model_unavailable` — модель сейчас недоступна, повторите после `Retry-After`.
- Руководство по API целиком: https://souz.ai/docs, спецификация OpenAPI: https://api.souz.ai/openapi.json.

## Параметры запроса

Отправляются поля из этой таблицы. Кроме них — общие поля задач `routing`, `routing_options`, `max_price_multiplier`, `store`, `callback_url` и `user`. Незнакомое поле — `400 invalid_request` с `detail[].reason: unsupported_field`; значение, которое у модели ничего не меняет, принимается молча. Вся схема тела машинно — `input_schema` в карточке `GET /v1/models/mai-transcribe-2` (JSON Schema).

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `file` | звук | да | файл до 25 МБ | — | Аудиофайл. Запись, которую нужно расшифровать. |
| `language` | строка | нет | текст | — | Язык записи. Код языка по ISO 639-1, например ru или en. Без него модель определит язык сама. |
| `response_format` | перечисление | нет | json, verbose_json, text, srt | `json` | Формат ответа. json — текст в объекте задачи, verbose_json — с таймкодами, text — только текст, srt — субтитры. |

## Примеры запроса

### cURL

```bash
curl https://api.souz.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -F "model=mai-transcribe-2" \
  -F "file=@audio.mp3" \
  -F "language=ru"
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]
with open("audio.mp3", "rb") as audio:
    response = requests.post("https://api.souz.ai/v1/audio/transcriptions",
        headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
        data={"model": "mai-transcribe-2", "language": "ru"},
        files={"file": audio},
    )
print(response.json())
```

### TypeScript

```typescript
const form = new FormData();
form.set("model", "mai-transcribe-2");
form.set("file", audioFile);
form.set("language", "ru");
const response = await fetch("https://api.souz.ai/v1/audio/transcriptions", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.SOUZ_API_KEY}` },
  body: form,
});
console.log(await response.json());
```

### Канал

```bash
curl https://api.souz.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -F "model=mai-transcribe-2" \
  -F "file=@audio.mp3" \
  -F 'routing_options={"only":["red"]}'
```

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

### Ответ

```json
{
  "id": "job_01k9m2",
  "object": "job",
  "created": 1774170000,
  "created_at": "2026-03-22T09:00:00Z",
  "completed_at": "2026-03-22T09:00:09Z",
  "model": "mai-transcribe-2",
  "modality": "transcription",
  "status": "completed",
  "routing": "cheap",
  "max_price_multiplier": null,
  "routing_options": null,
  "attempt_count": 1,
  "channel": "red",
  "price": 16762,
  "currency": "RUB",
  "usage": {
    "characters": 31
  },
  "data": [],
  "text": "Текст расшифровки аудиозаписи.",
  "language": "ru",
  "duration": 4.2,
  "error": null
}
```

## Вопросы и ответы

**Что такое MAI Transcribe 2?**

MAI Transcribe 2 — разбирает речь на фоне шума и сложные термины. Для совещаний, интервью и разговоров с клиентами. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит MAI Transcribe 2?**

MAI Transcribe 2 стоит 0,003991 ₽ за секунду. Цена не зависит от канала; скорость и стабильность каждого — в блоке «Каналы». Списывается только успешный запрос, неудачный не стоит ничего.

**Что MAI Transcribe 2 принимает на вход и что отдаёт?**

MAI Transcribe 2 принимает звук и отдаёт текст. В одном запросе: аудиофайл — одна ссылка https на звук.

**Какие форматы поддерживает MAI Transcribe 2?**

MAI Transcribe 2 поддерживает: формат ответа — JSON, JSON с таймкодами, Текст или Субтитры SRT, по умолчанию JSON.

**Как вызвать MAI Transcribe 2 через API?**

Запросом POST https://api.souz.ai/v1/audio/transcriptions с полем model: "mai-transcribe-2" и ключом СОЮЗа в заголовке Authorization: Bearer. Файл передаётся как multipart/form-data; ответ — объект задачи с текстом расшифровки, числом символов и итоговой ценой. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

**Что такое каналы MAI Transcribe 2 и как выбрать конкретный?**

MAI Transcribe 2 выполняется через один канал — «Красный» (red). У каждого канала свои ставки, задержка, скорость и стабильность за 7 дней — они в блоке «Каналы» на этой странице и в GET https://api.souz.ai/v1/models/mai-transcribe-2/channels. Цвет не означает «дешёвый» или «быстрый», а одинаковый цвет у другой модели — другой канал. По умолчанию канал выбирает Авто-роутинг по пресету «Дешевле», «Баланс» или «Быстрее». Конкретный канал задаёт поле routing_options: {"only": ["red"]} — только этот канал, {"order": ["red"]} — сначала он, затем остальные. Чтобы закрепить канал для всех запросов к модели, сохраните ту же настройку в аккаунте: PATCH https://api.souz.ai/v1/settings ключом управления или в кабинете. Каким каналом выполнен запрос, видно в поле channel ответа и в истории.

**Можно ли попробовать MAI Transcribe 2 без кода?**

Да: плейграунд на этой странице запускает MAI Transcribe 2 с теми же параметрами, что и API. Нужен аккаунт СОЮЗа. Итоговая стоимость считается по длительности аудио. Пока запрос выполняется, в истории вместо цены стоит прочерк; итог появляется только после завершения.

**Когда вышла MAI Transcribe 2?**

MAI Transcribe 2 выпущена Microsoft 17 июня 2026.

## Ссылки

- Страница модели: https://souz.ai/models/mai-transcribe-2
- Каталог моделей: https://souz.ai/models
- Все модели одним файлом: https://souz.ai/llms.txt
- Кабинет (ключи, баланс, история запросов): https://souz.ai/overview