Документация API Podhoc

Интегрируйте генерацию подкастов в свои приложения

API Podhoc позволяет программно создавать подкасты, сгенерированные ИИ, из общедоступных URL-адресов. Встройте генерацию подкастов в свои рабочие процессы, приложения и платформы.

Источники контента: API принимает только общедоступные URL-адреса. Загрузка файлов и необработанный текст в настоящее время не поддерживаются. Если у вашей организации есть требования по соответствию или безопасности, которые препятствуют публичному размещению, пожалуйста, создайте обращение в поддержку для обсуждения вариантов корпоративной интеграции.

Быстрый старт

1. Оформите подписку PRO на app.podhoc.com
2. Создайте API-токен на app.podhoc.com/account/api-access
3. Отправьте свой первый запрос, используя примеры ниже

Аутентификация

Все запросы к API требуют заголовок X-Api-Key с вашим токеном:

X-Api-Key: phk_test_a1b2c3d4e5f6...

Базовый URL: https://api-ext.podhoc.com/v1

Типы токенов:

• Тестовые токены (phk_test_...) – Дешевле, ограниченные функции. Для разработки и тестирования.
• Продакшн-токены (phk_prod_...) – Дороже, полный доступ. Для продакшн-использования.

Эндпоинты

POST /v1/podcasts – Создать подкаст

Запустите генерацию нового подкаста из одного или нескольких источников.

curl -X POST https://api-ext.podhoc.com/v1/podcasts \
  -H "X-Api-Key: phk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article"],
    "language": "ru",
    "target_duration_minutes": 10,
    "style": "conversational"
  }'

GET /v1/podcasts/{id}/status – Проверить статус генерации

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
  -H "X-Api-Key: phk_test_..."

Значения статуса: requested, processing, completed, failed.

GET /v1/podcasts/{id}/download – Скачать подкаст

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download \
  -H "X-Api-Key: phk_test_..."

GET /v1/estimate-cost – Оценить стоимость в кредитах

curl "https://api-ext.podhoc.com/v1/estimate-cost?duration_minutes=30&source_count=2&voice_count=2" \
  -H "X-Api-Key: phk_test_..."

GET /v1/account/credits – Проверить баланс кредитов

curl https://api-ext.podhoc.com/v1/account/credits \
  -H "X-Api-Key: phk_test_..."

Цены

Генерация подкастов использует динамическое ценообразование на основе кредитов. API применяет дополнительный множитель в зависимости от типа токена.

Формула:

Базовая стоимость:     max(30, ceil(длительность_минуты x 2.5))
Бонусы:                + 20, если больше 1 источника
                       + 10, если включены пользовательские веса
Масштабирование голосов: x 1.2, если больше 1 голоса
Лимит:                 min(500, макс_стоимость_тарифа)
Стоимость API:         базовые_кредиты x множитель_кредитов

Примеры стоимости по длительности (1 источник, 1 голос, без пользовательских весов):

Множители кредитов:

Множители кредитов (Дешевле для теста, Дороже для продакшн) являются уровнями по умолчанию. Они могут быть изменены – фактический множитель, примененный к вашему запросу, отображается в метаданных ответа.

Лимиты запросов

Коды ошибок

Тестовые vs продакшн-токены