# Gemini 3.1 Flash TTS

Озвучка текста голосом Google — 30 голосов, акценты, стиль и темп речи

## Обзор

- **Modality:** Озвучка
- **Modes:** Текст → Голос
- **Страница модели:** https://iskragen.ru/models/google-gemini-3-1-flash-tts
- **`modelSlug` для API:** `google-gemini-3-1-flash-tts`

## Стоимость

- Базовая цена: 6–6 ₽ за `1k_chars`

**Включено:**
- Язык определяется по тексту — отдельно выбирать не нужно
- Ремарки в квадратных скобках управляют подачей: [whispers], [laughs]

**Примечания:**
- Неполная тысяча символов округляется вверх

## Сценарии и параметры

### Текст → Голос

- Mode ID: `text-to-tts`
- `modelSlug` для API: `google-gemini-3-1-flash-tts`

| Поле | Тип | По умолчанию | Диапазон / опции | Описание |
| --- | --- | --- | --- | --- |
| `voice_name` | select | `Kore` | `Kore`, `Zephyr`, `Puck`, `Charon`, `Fenrir`, `Leda`, `Aoede`, `Sulafat`, `Achernar`, `Achird`, `Algenib`, `Algieba`, `Alnilam`, `Autonoe`, `Callirrhoe`, `Despina`, `Enceladus`, `Erinome`, `Gacrux`, `Iapetus`, `Laomedeia`, `Orus`, `Pulcherrima`, `Rasalgethi`, `Sadachbia`, `Sadaltager`, `Schedar`, `Umbriel`, `Vindemiatrix`, `Zubenelgenubi` | Тембр диктора. Модель сама подстраивается под язык текста. |
| `accent` | select | `Neutral` | `Neutral`, `American (Gen)`, `American (Valley)`, `American (South)`, `British (RP)`, `British (Brixton)`, `Transatlantic`, `Australian` |  |
| `style` | select | `none` | `none`, `Vocal Smile`, `Newscaster`, `Whisper`, `Empathetic`, `Promo/Hype`, `Deadpan` |  |
| `pace` | select | `Natural` | `Natural`, `Rapid Fire`, `The Drift`, `Staccato` | Скорость речи. |
| `scene` | text | — | строка | Необязательно: где и как звучит речь, например «спокойный вечерний подкаст» |
| `sample_context` | text | — | до 500 символов | Необязательно: кому и в какой ситуации говорит диктор, например «аудиокнига, мягкий доверительный тон» |
| `temperature` | slider | 1 | 0–2, шаг 0.1 | Разнообразие интонации: 0 — предсказуемо, 2 — максимально вольно |

## Использование через API

Полный цикл интеграции: API-ключ → создание генерации → polling → результат. Базовый URL: `https://api.iskragen.ru/v1`.

### 1. Получите API-ключ

Личный кабинет → «API-ключи» (https://iskragen.ru/api-keys). Значение показывается один раз. Ключ передаётся в заголовке каждого запроса:

```
Authorization: Bearer iskr_live_<secret>
```

### 2. Создайте генерацию

```bash
curl -X POST https://api.iskragen.ru/v1/generations \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "modelSlug": "google-gemini-3-1-flash-tts",
  "prompt": "Опишите, что вы хотите сгенерировать",
  "params": {
    "voice_name": "Kore",
    "accent": "Neutral",
    "style": "none",
    "pace": "Natural",
    "temperature": 1
  }
}'
```

Генерация асинхронная: ответ — `202 Accepted`, задача ставится в очередь, стоимость удерживается с баланса.

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "PENDING",
  "costRub": 6
}
```

### 3. Дождитесь результата (polling)

Опрашивайте `GET /v1/generations/{id}` раз в ~2 секунды, пока `status` не станет `SUCCEEDED` или `FAILED`:

```bash
curl https://api.iskragen.ru/v1/generations/$GENERATION_ID \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY"
```

```json
{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "SUCCEEDED",
  "outputUrls": ["https://s3.twcstorage.ru/.../result.webp"],
  "costRub": 6,
  "errorCode": null,
  "errorMessage": null
}
```

- `outputUrls` — ссылки на готовые файлы; заполняются при `SUCCEEDED`.
- При `FAILED` средства возвращаются на баланс автоматически, причина — в `errorCode` / `errorMessage`.
- Лимит: 5 одновременных генераций (`PENDING` + `PROCESSING`), при превышении — `429`.
- Для длинных задач (видео, музыка) вместо polling'а используйте [Webhooks](https://iskragen.ru/docs/webhooks.md).

### Полная документация

- Generations API (все поля, image-to-image, ошибки): https://iskragen.ru/docs/api-generations.md
- Аутентификация: https://iskragen.ru/docs/authentication.md
- Ошибки: https://iskragen.ru/docs/errors.md
- Лимиты: https://iskragen.ru/docs/rate-limits.md
- Индекс всей документации для LLM: https://iskragen.ru/llms.txt
- Машиночитаемый каталог моделей (slug, params, цены): https://api.iskragen.ru/v1/catalog