# Aura-2 — синтез речи, Deepgram, через API СОЮЗа

> Идентификатор для поля `model`: `aura-2`. Страница: https://souz.ai/models/aura-2. Текст → Речь. Выпущена 15 апреля 2025.

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

Aura-2 — деловая подача на семи языках и темп на выбор. Для голосовых меню, ботов и уведомлений клиентам.

## Цены

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

- Символы текста — 4 310 ₽ за 1M

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

- Цена по каналам: Синий (`blue`) — 4 310 ₽ за 1M символов.

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

## Каналы

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

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

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

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

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["blue"]}` — только этот канал, без запасных; `{"order": ["blue"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `max_price` — пределы ставок. SDK OpenAI — через `extra_body`.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/aura-2/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`), у каждого оценка `estimated_price`; запрос начнётся с первого. Пустой `channels` — с такими условиями запрос не выполнить. Настройки аккаунта превью применяет, как запрос.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"aura-2": {"only": ["blue"]}}}`. 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/speech`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — JSON, `Content-Type: application/json`, поле `model` — `aura-2`.
- Ответ — байты звука в родном формате модели, id задачи — в заголовке `X-Job-Id` (так ждёт SDK OpenAI). С `Accept: application/json` — объект задачи: звук в `data[0].url`, `usage.seconds`, `usage.billed_characters` и итог `price`.
- Ошибки — 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/aura-2` (JSON Schema).

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `input` | строка | да | текст, до 2 000 символов | — | Текст. До 2000 символов. Язык задаёт голос: английский, испанский, немецкий, французский, итальянский, нидерландский или японский. |
| `voice` | перечисление | нет | aura-2-thalia-en, aura-2-amalthea-en, aura-2-andromeda-en, aura-2-apollo-en, aura-2-arcas-en, aura-2-aries-en, aura-2-asteria-en, aura-2-athena-en, aura-2-atlas-en, aura-2-aurora-en, aura-2-callista-en, aura-2-cora-en, aura-2-cordelia-en, aura-2-delia-en, aura-2-draco-en, aura-2-electra-en, aura-2-harmonia-en, aura-2-helena-en, aura-2-hera-en, aura-2-hermes-en, aura-2-hyperion-en, aura-2-iris-en, aura-2-janus-en, aura-2-juno-en, aura-2-jupiter-en, aura-2-luna-en, aura-2-mars-en, aura-2-minerva-en, aura-2-neptune-en, aura-2-odysseus-en, aura-2-ophelia-en, aura-2-orion-en, aura-2-orpheus-en, aura-2-pandora-en, aura-2-phoebe-en, aura-2-pluto-en, aura-2-saturn-en, aura-2-selene-en, aura-2-theia-en, aura-2-vesta-en, aura-2-zeus-en, aura-2-agustina-es, aura-2-alvaro-es, aura-2-antonia-es, aura-2-aquila-es, aura-2-carina-es, aura-2-celeste-es, aura-2-diana-es, aura-2-estrella-es, aura-2-gloria-es, aura-2-javier-es, aura-2-luciano-es, aura-2-nestor-es, aura-2-olivia-es, aura-2-selena-es, aura-2-silvia-es, aura-2-sirio-es, aura-2-valerio-es, aura-2-aurelia-de, aura-2-elara-de, aura-2-fabian-de, aura-2-julius-de, aura-2-kara-de, aura-2-lara-de, aura-2-viktoria-de, aura-2-agathe-fr, aura-2-hector-fr, aura-2-cesare-it, aura-2-cinzia-it, aura-2-demetra-it, aura-2-dionisio-it, aura-2-elio-it, aura-2-flavio-it, aura-2-livia-it, aura-2-maia-it, aura-2-melia-it, aura-2-beatrix-nl, aura-2-cornelia-nl, aura-2-daphne-nl, aura-2-hestia-nl, aura-2-lars-nl, aura-2-leda-nl, aura-2-rhea-nl, aura-2-roman-nl, aura-2-sander-nl, aura-2-ama-ja, aura-2-ebisu-ja, aura-2-fujin-ja, aura-2-izanami-ja, aura-2-uzume-ja | `aura-2-thalia-en` | Голос |
| `response_format` | перечисление | нет | mp3, wav | `mp3` | Формат звука |
| `speed` | число | нет | число, от 0,7 до 1,5, шаг 0,05 | `1` | Темп. 1 — обычный темп. Меняет темп английских и испанских голосов. |

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

### cURL

```bash
curl https://api.souz.ai/v1/audio/speech \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aura-2",
    "input": "Добро пожаловать в СОЮЗ. Ваше аудио готово.",
    "voice": "aura-2-thalia-en",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]

response = requests.post(
    "https://api.souz.ai/v1/audio/speech",
    headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
    json={
      "model": "aura-2",
      "input": "Добро пожаловать в СОЮЗ. Ваше аудио готово.",
      "voice": "aura-2-thalia-en",
      "response_format": "mp3",
      "speed": 1
    },
)
response.raise_for_status()
with open("speech.mp3", "wb") as audio:
    audio.write(response.content)
print(response.headers["X-Job-Id"])
```

### TypeScript

```typescript
import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.souz.ai/v1/audio/speech", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOUZ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "aura-2",
    "input": "Добро пожаловать в СОЮЗ. Ваше аудио готово.",
    "voice": "aura-2-thalia-en",
    "response_format": "mp3",
    "speed": 1
  }),
});
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));
console.log(response.headers.get("X-Job-Id"));
```

### Канал

```bash
curl https://api.souz.ai/v1/audio/speech \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aura-2",
    "input": "Добро пожаловать в СОЮЗ. Ваше аудио готово.",
    "voice": "aura-2-thalia-en",
    "response_format": "mp3",
    "speed": 1,
    "routing_options": {
      "only": [
        "blue"
      ]
    }
  }' \
  --output speech.mp3
```

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

### Звук

```
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Job-Id: job_01voice

<байты звука>
```

### Accept: application/json

```json
{
  "id": "job_01voice",
  "object": "job",
  "created": 1774170000,
  "created_at": "2026-03-22T09:00:00Z",
  "completed_at": "2026-03-22T09:00:09Z",
  "model": "aura-2",
  "modality": "speech",
  "status": "completed",
  "routing": "cheap",
  "max_price_multiplier": null,
  "routing_options": null,
  "attempt_count": 1,
  "channel": "blue",
  "price": 185330,
  "currency": "RUB",
  "usage": {
    "characters": 43,
    "billed_characters": 43,
    "seconds": 3.2
  },
  "data": [
    {
      "id": "file_01voice",
      "object": "file",
      "kind": "result",
      "type": "audio",
      "role": "result",
      "url": "https://media.souz.ai/v1/files/file_01voice/souz_aura-2_01voice.mp3?exp=1774774809&sig=…",
      "content_type": "audio/mpeg",
      "filename": "souz_aura-2_01voice.mp3",
      "bytes": 51200,
      "created_at": "2026-03-22T09:00:09Z",
      "expires_at": "2026-03-29T09:00:09Z",
      "expired": false
    }
  ],
  "error": null
}
```

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

**Что такое Aura-2?**

Aura-2 — деловая подача на семи языках и темп на выбор. Для голосовых меню, ботов и уведомлений клиентам. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит Aura-2?**

Aura-2 стоит 4 310 ₽ за 1M. Цена не зависит от канала; скорость и стабильность каждого — в блоке «Каналы». Списывается только успешный запрос, неудачный не стоит ничего.

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

Aura-2 принимает текст и отдаёт речь.

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

Aura-2 поддерживает: голос — Thalia · English (US), Amalthea · English (PH), Andromeda · English (US), Apollo · English (US), Arcas · English (US), Aries · English (US), Asteria · English (US), Athena · English (US), Atlas · English (US), Aurora · English (US), Callista · English (US), Cora · English (US), Cordelia · English (US), Delia · English (US), Draco · English (UK), Electra · English (US), Harmonia · English (US), Helena · English (US), Hera · English (US), Hermes · English (US), Hyperion · English (AU), Iris · English (US), Janus · English (US), Juno · English (US), Jupiter · English (US), Luna · English (US), Mars · English (US), Minerva · English (US), Neptune · English (US), Odysseus · English (US), Ophelia · English (US), Orion · English (US), Orpheus · English (US), Pandora · English (UK), Phoebe · English (US), Pluto · English (US), Saturn · English (US), Selene · English (US), Theia · English (AU), Vesta · English (US), Zeus · English (US), Agustina · Español (ES), Alvaro · Español (ES), Antonia · Español (AR), Aquila · Español (LatAm), Carina · Español (ES), Celeste · Español (CO), Diana · Español (ES), Estrella · Español (MX), Gloria · Español (CO), Javier · Español (MX), Luciano · Español (MX), Nestor · Español (ES), Olivia · Español (MX), Selena · Español (LatAm), Silvia · Español (ES), Sirio · Español (MX), Valerio · Español (MX), Aurelia · Deutsch, Elara · Deutsch, Fabian · Deutsch, Julius · Deutsch, Kara · Deutsch, Lara · Deutsch, Viktoria · Deutsch, Agathe · Français, Hector · Français, Cesare · Italiano, Cinzia · Italiano, Demetra · Italiano, Dionisio · Italiano, Elio · Italiano, Flavio · Italiano, Livia · Italiano, Maia · Italiano, Melia · Italiano, Beatrix · Nederlands, Cornelia · Nederlands, Daphne · Nederlands, Hestia · Nederlands, Lars · Nederlands, Leda · Nederlands, Rhea · Nederlands, Roman · Nederlands, Sander · Nederlands, Ama · 日本語, Ebisu · 日本語, Fujin · 日本語, Izanami · 日本語 или Uzume · 日本語, по умолчанию Thalia · English (US); формат звука — MP3 или WAV, по умолчанию MP3; темп — от 0,7 до 1,5, по умолчанию 1.

**Как вызвать Aura-2 через API?**

Запросом POST https://api.souz.ai/v1/audio/speech с полем model: "aura-2" и ключом СОЮЗа в заголовке Authorization: Bearer. Ответ — готовый звук, id задачи — в заголовке X-Job-Id; с заголовком Accept: application/json приходит объект задачи со ссылкой на файл, длительностью, числом символов и итоговой ценой. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

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

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

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

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

**Когда вышла Aura-2?**

Aura-2 выпущена Deepgram 15 апреля 2025.

## Ссылки

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