Текст в речь (HTTP)

Клонирование голоса - создать модель

Липсинк - создать задачу

Профиль пользователя

Текст в речь (HTTP) (HTTP)

REST-синтез с ID голосовой модели и настройками движка.

Текст в речь (HTTP)

Эндпоинт

POST /api/open/v1/speech/tts

Заголовки запроса

// Параметры запроса
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // API ключ

// Параметры запроса
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // API ключ

Параметры запроса

Пример параметров запроса

Доступные варианты:

  • • Текст в речь (HTTP): v1, v2, s1
  • • Текст в речь (HTTP v2): v3-turbo, v3-hd
  • • Необязательно: Синтез речи по ID голоса с дополнительными настройками движка.

Данные ответа

// Данные ответа (cache=false) - 200
Content-Type: audio/mpeg
<Несколько форматов>

// Данные ответа (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // Данные ответа
  "audio_url": string,       // Речь в текст
  "format": string,          // Несколько форматов
  "characters_used": number, // Параметры запроса
  "quota_remaining": number  // Остаток API-квоты и базовая информация аккаунта.
}

// Запрос не выполнен
{
  "error": string     // Запрос не выполнен
}

Пример CURL

# Параметры запроса - Необязательно
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "fishaudio-s21pro-flash",
    "text": "Речь в текст",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Параметры запроса - Доступные варианты:
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "minimax-2.8-hd",
    "text": "Речь в текст",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Параметры запроса (undefined)

Онлайн-отладка

Коды статуса

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error