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

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

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

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

Поле	Тип	Обяз.	Описание
`instruction`	string	да	Описание голоса (1–2000 символов; рекомендуем 20–1000 — в зависимости от конфигурации сервиса более короткие или длинные описания могут отклоняться с `422`)
`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": "...",
      "mime_type": "audio/wav",
      "sample_rate": 44100,
      "duration_ms": 3200,
      "text": "[смеётся] Привет! Это превью нового голоса."
    }
  ],
  "cost_rub": "1.3500",
  "balance_rub": "98.6500"
}

Декодируйте audio_base64 для прослушивания превью; формат указан в mime_type (audio/wav или audio/mpeg).

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

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

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

Поле	Тип	Обяз.	Описание
`title`	string	да	Название голоса
`description`	string	нет	Описание голоса, до 500 символов. Отображается в библиотеке и в `GET /v1/voices`
`candidate_id`	string	да	`id` выбранного кандидата
`instruction`	string	да	То же описание, по которому генерировались кандидаты
`audio`	file	да	WAV/MP3 выбранного кандидата

Передавайте все три поля: в зависимости от конфигурации сервиса голос строится либо по candidate_id, либо по аудио. id кандидата действителен ограниченное время, поэтому сохраняйте голос вскоре после генерации.

curl -X POST https://tryaxolotl.ru/v1/voices/from-design \
  -H "Authorization: Bearer $AXOLOTL_API_KEY" \
  -F "title=Тёплый диктор" \
  -F "description=Спокойный голос для обучающих роликов" \
  -F "candidate_id=cand_0" \
  -F "instruction=Тёплый уверенный диктор с естественной интонацией" \
  -F "audio=@candidate.wav"

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

Тарификация

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

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

Руководства

Справочник

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

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

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

Тарификация

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

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

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

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

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

Тарификация