API Ссылка
Kitta Audio Откройте ссылку на конечную точку API.
API Ссылка
Kitta Audio Open API — это серверный интерфейс для рабочих процессов производства аудио. Используйте его, когда вашему продукту требуется преобразование текста в речь, речь в текст, голосовое управление или автоматизация синхронизации губ, не полагаясь на веб-консоль.
Базовый URL:
https://kittaai.com/api/open/v1Аутентификация:
Authorization: Bearer KITTA_API_KEYМашиночитаемая схема:
GET /api/openapi.jsonТекущие общедоступные поверхности
| Поверхность | Текущий статус API за рубежом | Документы |
|---|---|---|
| Профиль | Публичная конечная точка v1 для проверки учетных записей, уровней, кредитов и квот | Профиль |
| Преобразование текста в речь | Публичная синхронизация HTTP и конечные точки асинхронных заданий | Синхронизировать HTTP, Асинхронные задания |
| В реальном времени TTS | Доступность контролируется учетной записью и выпуском продукта | В реальном времени TTS |
| Речь в текст | Публичная конечная точка транскрипции HTTP | Речь в текст |
| В реальном времени ASR | Доступность контролируется учетной записью и выпуском продукта | В реальном времени ASR |
| Изображения | Страница возможностей продукта; доступность общедоступных конечных точек управляется схемой | Изображения |
| Видео | Страница возможностей продукта; доступность общедоступных конечных точек управляется схемой | Видео |
| Голосовое управление | Откройте конечные точки API для просмотра, создания и удаления моделей голоса | Голосовое управление |
| Синхронизация губ | Публичные конечные точки асинхронных заданий для рабочих процессов исходного видео и аудио | Синхронизация губ |
| Использование | Руководство по использованию учетной записи; использовать профиль сегодня и схему для новых конечных точек использования | Использование |
Модель запроса
Все запросы должны осуществляться с вашего сервера. Клиенты браузера и мобильные приложения должны сначала вызвать ваш собственный бэкэнд, а затем ваш бэкэнд вызывает Open API с ключом API.
curl https://kittaai.com/api/open/v1/profile \
-H "Authorization: Bearer KITTA_API_KEY"Используйте JSON для большинства конечных точек. При создании голоса могут использоваться данные составной формы, если включенному поставщику требуется эталонный звук. Двоичные аудиоответы используются синхронизацией TTS, когда вы запрашиваете прямой звук вместо кэшированных метаданных.
Модель ответа
Успешные ответы зависят от конечной точки. Асинхронные конечные точки возвращают объекты заданий или задач, которые ваше приложение должно опрашивать до тех пор, пока не будет достигнуто состояние терминала. Конечные точки мультимедиа синхронизации могут возвращать двоичные данные или метаданные JSON в зависимости от параметров запроса.
Ошибки используют тело JSON:
{
"code": "invalid_request",
"message": "The request payload is invalid.",
"requestId": "req_xxx"
}Зарегистрируйте requestId, если он присутствует. Это самый быстрый способ для службы поддержки отследить неудавшийся запрос.
Выставление счетов и кредиты
Открытые вызовы API расходуют кредиты счета или квоту API в зависимости от конечной точки и включенной модели. Некоторые конечные точки взимают плату при принятии задачи; другие взимают плату, когда медиа-генерация успешна. Ваша интеграция должна отображать четкое состояние повтора и не должна предполагать, что за каждый неудачный запрос будут взиматься кредиты.
Для рабочих процессов, чувствительных к балансу, вызывайте Профиль перед запуском больших пакетов и после завершения важных заданий. Длительно выполняемые задания также должны сохранять возвращаемый идентификатор задачи, чтобы можно было восстановиться после перезапуска клиента без создания дублирующей работы.
Совместимость
Устаревшие пути Open API остаются доступными в течение окна совместимости, но в новых интеграциях следует использовать /api/open/v1. В руководстве по миграции перечислены известные замены путей и порядок развертывания.
Зарубежные врачи намеренно используют свои текущие пути. Если вы интегрируете глобальный сайт, следуйте путям в разделе https://kittaai.com/api/open/v1 и подтвердите новые поверхности с помощью GET /api/openapi.json.