Дизайн голоса

Voice Design создаёт краткие аудио-кандидаты по промпту. Это stateless-операция: голос не сохраняется автоматически. Чтобы использовать его в синтезе, сохраните понравившийся кандидат через сохранение из дизайна.

Генерация кандидатов

POST https://tryaxolotl.ru/v1/voice-design
Content-Type: application/json

Поле	Тип	Обяз.	Описание
`instruction`	string	да	Описание голоса (1–2000 символов)
`reference_text`	string	нет	Текст превью (до 150 символов)
`language`	string	нет	Язык, например `ru` или `en`
`n`	integer	нет	Число кандидатов (1–4, по умолчанию 2)

curl -X POST https://tryaxolotl.ru/v1/voice-design \
  -H "Authorization: Bearer $AXOLOTL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instruction": "Тёплый уверенный диктор с естественной интонацией",
    "reference_text": "[смеётся] Привет! Это превью нового голоса.",
    "language": "ru",
    "n": 2
  }'

Ответ (сокращённо)

{
  "candidates": [
    {
      "id": "cand_0",
      "index": 0,
      "audio_base64": "...",
      "sample_rate": 44100,
      "duration_ms": 3200,
      "text": "[смеётся] Привет! Это превью нового голоса."
    }
  ],
  "cost_rub": "1.3500",
  "balance_rub": "98.6500"
}

Декодируйте audio_base64 для прослушивания WAV-превью.

Сохранение в библиотеку

После выбора кандидата отправьте его аудио как файл:

POST https://tryaxolotl.ru/v1/voices/from-design
Content-Type: multipart/form-data

Поле	Тип	Обяз.	Описание
`title`	string	да	Название голоса
`description`	string	нет	Описание
`audio`	file	да	WAV/MP3 выбранного кандидата

curl -X POST https://tryaxolotl.ru/v1/voices/from-design \
  -H "Authorization: Bearer $AXOLOTL_API_KEY" \
  -F "title=Тёплый диктор" \
  -F "audio=@candidate.wav"

Голос появится в GET /v1/voices с scope: private, source: designed.

Тарификация

Voice Design тарифицируется за успешный запрос (не за каждого кандидата). Стоимость возвращается в поле cost_rub. См. Тарификация.

Начало работы

Руководства

Справочник

Дизайн голоса

Генерация кандидатов

Сохранение в библиотеку

Тарификация

​Генерация кандидатов

​Сохранение в библиотеку

​Тарификация

Генерация кандидатов

Сохранение в библиотеку

Тарификация