Fish Audio — Диалог до 4 Голосов

POST /sounds/fish-dialogue

Многоголосый диалог: пришлите реплики lines, у каждой — текст и voice_id говорящего. Максимум 4 разных голоса и 50 реплик. Результат — один аудиофайл со всем диалогом, заберите его через GET /task/{task_id}. Лимит: 10 запросов/мин.

Базовый URL: https://api.aihere.ru/api/v1
Авторизация: Authorization: Bearer <API-ключ>
Rate-limit: 10 запросов/мин

Параметры

Поле	Тип	Обяз.	Описание
format	string	—	значения: mp3, wav, pcm, opus; по умолчанию mp3
speed	number (опционально)	—	мин: 0.5; макс: 2.0
volume	number (опционально)	—	мин: -10.0; макс: 10.0
normalize_loudness	boolean (опционально)	—	—
normalize	boolean (опционально)	—	—
latency	string	—	значения: normal, balanced; по умолчанию normal
lines	array[object]	да	мин. элементов: 2; макс. элементов: 50

Примеры

cURL

curl -X POST "https://api.aihere.ru/api/v1/sounds/fish-dialogue" \
  -H "Authorization: Bearer $AIHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Callback-Url: https://myapp.example.com/api/aihere-callback" \
  -d '{
  "format": "mp3",
  "latency": "normal",
  "lines": [
    {
      "text": "Привет! Как дела?",
      "voice_id": "728f6ff2240d49308e8137ffe66008e2"
    },
    {
      "text": "Отлично! А у тебя?",
      "voice_id": "8f4c2e1b0a3d4f5e9c6b7a8d1e2f3041"
    }
  ]
}'

Python

import requests

payload = {
    "format": "mp3",
    "latency": "normal",
    "lines": [
        {
            "text": "Привет! Как дела?",
            "voice_id": "728f6ff2240d49308e8137ffe66008e2"
        },
        {
            "text": "Отлично! А у тебя?",
            "voice_id": "8f4c2e1b0a3d4f5e9c6b7a8d1e2f3041"
        }
    ]
}

resp = requests.post(
    "https://api.aihere.ru/api/v1/sounds/fish-dialogue",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        # Опционально: вебхук о завершении задачи
        # "X-Callback-Url": "https://myapp.example.com/api/aihere-callback",
    },
    json=payload,
    timeout=60,
)
resp.raise_for_status()
task_id = resp.json()["task_id"]
print(f"Задача №{task_id} поставлена")

JavaScript

const resp = await fetch("https://api.aihere.ru/api/v1/sounds/fish-dialogue", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
    // Опционально: "X-Callback-Url": "https://myapp.example.com/api/aihere-callback",
  },
  body: JSON.stringify({
  "format": "mp3",
  "latency": "normal",
  "lines": [
    {
      "text": "Привет! Как дела?",
      "voice_id": "728f6ff2240d49308e8137ffe66008e2"
    },
    {
      "text": "Отлично! А у тебя?",
      "voice_id": "8f4c2e1b0a3d4f5e9c6b7a8d1e2f3041"
    }
  ]
}),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${await resp.text()}`);
const { task_id } = await resp.json();
console.log("Задача №" + task_id + " поставлена");

PHP

$payload = json_decode('{"format": "mp3", "latency": "normal", "lines": [{"text": "Привет! Как дела?", "voice_id": "728f6ff2240d49308e8137ffe66008e2"}, {"text": "Отлично! А у тебя?", "voice_id": "8f4c2e1b0a3d4f5e9c6b7a8d1e2f3041"}]}', true);

$ch = curl_init('https://api.aihere.ru/api/v1/sounds/fish-dialogue');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $apiKey",
        'Content-Type: application/json',
        // Опционально: 'X-Callback-Url: https://myapp.example.com/api/aihere-callback',
    ],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Задача №{$resp['task_id']} поставлена";

Ответ 200

ID задачи (результат — аудиофайл с диалогом)

{
  "task_id": 123
}

Ошибки

Код	Причина
429	Превышен rate-limit
502	Ошибка провайдера генерации
503	Провайдер недоступен или сбой сервиса баланса (списанные средства возвращаются)
422	Ошибка валидации тела запроса (detail содержит список полей)
401	Нет или невалидный API-ключ