Как генерировать подкасты через API Podhoc: полное руководство
Генерируйте ИИ-подкасты программно через REST API Podhoc. Аутентификация, цикл создание-опрос-загрузка, лимиты частоты, оценка кредитов.
Для создания и смены тестовых и рабочих токенов нужен активный или пробный Pro. Тесты тратят настоящие кредиты: это не бесплатная песочница. Храните ключи на сервере, не в браузере, URL, логах или Git.
Источники — поддерживаемые публичные URL. Файлы и вставленный текст API не принимает. Не публикуйте конфиденциальные документы ради этого метода.
Первый безопасный запрос
Пример использует вымышленный публичный источник и тратит кредиты. Проверьте баланс и оценку, затем одобрите бюджет. Пять минут с одним голосом стоят 72 кредита при стандартном тестовом множителе; при других настройках используйте полученную оценку.
До отправки сохраните новый Idempotency-Key для каждого намеренного создания. Неопределённый запрос повторяйте с той же ключом и телом: вернётся исходная квитанция. Другое тело даёт 409. Тайм-аут не повод менять ключ.
Лимиты и цены
Тест: 2 запроса/минуту, 20/час, 1 одновременная генерация, до 5 минут, 1 URL, английский. Production: 30/минуту, 300/час, 5 одновременно в пределах Pro. При 429 соблюдайте Retry-After.
База: max(36, ceil(минуты × 10 / 3)). Несколько источников: +27; веса: +13; несколько стандартных голосов: ×1,2 с округлением и лимитом. Затем множитель API: по умолчанию 2× тест, 3,5× production, настраиваемый. 30 минут/источник/голос production: 100 × 3,5 = 350 кредитов. Тест не допускает 30 минут.
Вызывайте estimate-cost с теми же настройками; проверяйте final_credits, credit_multiplier и остаток. Длительность примерная; цена зависит от запроса, а не секундомера готового аудио.
Статус, скачивание и ошибки
В тесте опрашивайте не чаще раза в 240 секунд, максимум 12 раз, оставляя запросы для других действий. В production используйте ограниченный опрос и заголовки лимитов. Если ещё не готово, сохраните ID и вернитесь позже, не создавайте дубль. Webhook завершения здесь не обещается.
Скачивайте после completed. До повтора проверьте причину, баланс и возврат. URL временный и приватный; не публикуйте его как постоянную ссылку.
Приватность, публикация и удаление
Результат по умолчанию публичный. Creator и Pro позволяют создавать приватно; приватный выпуск можно опубликовать позже, подтвердив права. Рабочий API учитывает выбор владельца с подпиской; тестовые токены не могут публиковать. Для приватного создания явно передайте auto_publish=false с аккаунтом Pro.