Popcraft API
Все ведущие ИИ-модели через один эндпоинт.
Внедрите генерацию изображений, видео, аудио и аватаров прямо в свой продукт. Popcraft берёт на себя постановку в очередь, обеспечение справедливости, повторные попытки и биллинг — вы отправляете один промпт и получаете результат.
Доступно для корпоративных организаций · Оплата только за успешные генерации
# один промпт на входе — ID задачи на выходе, мгновенно
POST /v1/images/generations
{
"model": "nano-banana-2",
"prompt": "a tiny origami fox on a desk, soft morning light"
}
202 Accepted
{ "id": "job_9f2c1a", "status": "queued", "credits_reserved": 6 }Изображение
Генерация по тексту и с использованием референсов в рабочих разрешениях: от быстрых черновиков до флагманского качества.
Видео
Кинематографичная генерация видео по тексту и изображениям с явным указанием длительности и разрешения — оплата за секунду, цена известна заранее.
Аудио
Речь, звуковые эффекты и музыка. Длительность задаётся явно, поэтому стоимость в кредитах известна точно до того, как будет отрисован хотя бы один кадр.
Аватар
Оживляйте статичный портрет с помощью аудио или текста (TTS) для создания видео с говорящим аватаром — один вызов, один клип.
Создано для продакшена
Сложные задачи уже решены.
Генерация — процесс медленный, неравномерный и дорогой в случае ошибки. Платформа спроектирована так, чтобы высокая нагрузка от одного арендатора не задерживала выполнение задания другого.
Встроенное обнаружение утечек
Объём и скорость запросов к каждому API-ключу, а также доступ из незнакомых стран отслеживаются. Любая подозрительная активность мгновенно оповещает владельца — так скомпрометированный ключ обнаруживается за считанные минуты, а не в счёте на оплату.
Лимиты провайдера — под контролем
Ограничения параллелизма по типам и бюджеты запросов по моделям автоматически удерживают вас в рамках лимитов провайдера. Обратное давление — это чистый ответ 429, а не молчаливая потеря данных.
Надежность по умолчанию
Каждое задание сохраняется в момент принятия. Развертывания, перезапуски и сбои экземпляров не приводят к потере заданий или повторному списанию средств.
Асинхронность с первого байта
Запросы возвращают идентификатор задания за миллисекунды. Опрашивайте состояние или используйте вебхук, чтобы получить результат сразу после его готовности.
Подписанные вебхуки
Терминальные события доставляются с HMAC-подписью и повторяются при сбое — поэтому вы можете полностью отказаться от опроса и при этом никогда не пропустить результат.
Актуальный каталог моделей
Запрашивайте доступные модели, их возможности, лимиты и стоимость в кредитах во время выполнения. Новые модели появляются без необходимости менять ваш код.
Тарифы
Начинайте с базовых функций. Масштабируйтесь с Enterprise.
Никаких запутанных тарифов. Каждая организация начинает с одних и тех же разумных настроек по умолчанию и платит только за то, что генерирует. Когда вам потребуется большая пропускная способность, тариф Enterprise превратит каждое ограничение в число, которое мы установим вместе с вами — с приоритетом на параллелизм.
Для любой организации · с первого дня
По умолчанию
Всё, что нужно для создания, запуска и самостоятельного обслуживания.
Оплата по факту
только кредиты · без обязательств
- Параллелизм10 изображений · 4 видео · 6 аудио · 2 аватара в обработке
- Частота запросов60 / мин.
- Глубина очереди50 в очереди для каждого типа
- ДоставкаОпрос или подписанный вебхук
- Контроль расходовЛимиты на ключ и общий потолок организации
При масштабировании · договорные условия
Enterprise
Та же платформа, где каждый лимит увеличен до нужного вам значения.
Обсудим
договорная ставка и лимиты
- ПараллелизмУвеличено под вашу пропускную способность — укажите число
- Скорость и ёмкостьБолее высокий RPM · выделенные бюджеты на модель
- Коммерческие условияВыставление счетов · нетто-условия · SLA
- ГарантииПроверка безопасности · DPA · выделенный инженер
- Контроль расходовПользовательские потолки, всё ещё под контролем владельца
Возможность для переговоров
Вы можете увеличить уровень параллелизма.
Значения по умолчанию — это минимум, а не максимум. В тарифе Enterprise каждый из этих параметров — сколько заданий выполняется одновременно, как быстро можно отправлять запросы, какова глубина очереди — настраивается индивидуально и применяется для всей организации. Никаких изменений в коде и новых ключей с вашей стороны.
| Параметр | По умолчанию | В тарифе Enterprise |
|---|---|---|
| Задачи по изображениям в обработке | 10 параллельных задач | Свяжитесь с нами для увеличения лимитов |
| Видеозадачи в обработке | 4 одновременных | Свяжитесь с нами для увеличения лимитов |
| Аудиозадачи в обработке | 6 параллельных задач | Свяжитесь с нами для увеличения лимитов |
| Задачи по аватарам в обработке | 2 параллельные задачи | Свяжитесь с нами для увеличения лимитов |
| Запросов / мин | 60 | Свяжитесь с нами для увеличения лимитов |
| Глубина очереди | 50 в очереди для каждого типа | Свяжитесь с нами для увеличения лимитов |
| Емкость на модель | Общий пул | Свяжитесь с нами для получения выделенных ресурсов |
| Ежемесячный лимит кредитов | Вы устанавливаете его | Свяжитесь с нами для увеличения лимитов |
Это реальные элементы управления, применяемые для каждой организации в момент изменения вашего плана. Увеличение пропускной способности — это предмет обсуждения, а не миграция.
Расходы и безопасность
Владелец держит всё под контролем.
Передача ключа разработчику не означает передачу контроля над бюджетом. Владелец устанавливает лимиты расходов, следит за каждым кредитом и блокирует всё подозрительное — без необходимости открывать тикет.
Ограничьте расходы
Установите ежемесячный потолок для всей организации и кредитный лимит для каждого ключа. Оба ограничения применяются при отправке запроса — запрос, превышающий лимит, отклоняется до того, как он успеет потратить хотя бы один кредит.
Пресекайте злоупотребления на раннем этапе
Каждый ключ отслеживается на предмет резких скачков объёма и скорости запросов, а также вызовов из незнакомых стран. Владелец получает уведомление по электронной почте и в консоли, как только ключ выглядит скомпрометированным — его можно отозвать одним кликом.
Никаких неожиданных счетов
Неудачные, отменённые и прерванные по тайм-ауту задания не оплачиваются. Благодаря лимитам и уведомлениям скомпрометированный ключ просто не сможет создать счёт, который вы не подтверждали.
Биллинг
Вы платите за результат, а не за попытки.
Кредиты резервируются при отправке задания и списываются только после его завершения. За неудачные, отменённые или прерванные по тайм-ауту задания плата не взимается, поэтому возврат средств вам просто не понадобится.
Точные расценки заранее: стоимость каждого запроса рассчитывается по актуальному каталогу до его выполнения, а расчёт ожидаемого остатка при каждом чтении статуса позволяет вам всегда знать, что вы можете себе позволить.
Вопросы от отдела закупок.
Использование оплачивается кредитами и списывается с ежемесячного баланса вашей организации — это общий баланс, а не отдельный кошелек для каждого разработчика. Стоимость каждого запроса определяется заранее на основе актуального каталога, и списание происходит только после завершения задачи. Неудачные, отмененные и просроченные задачи не оплачиваются.
Да, на двух уровнях: общий лимит организации на цикл и кредитный лимит на каждый ключ, чтобы одна интеграция не могла исчерпать весь бюджет. Оба лимита проверяются при отправке — запрос, превышающий лимит, отклоняется до того, как он успеет потратить кредит. Владелец контролирует оба уровня.
В консоли отображается статистика использования в реальном времени по API-ключам и участникам команды, а также журнал недавних задач и списаний. Вы можете экспортировать отчет в формате CSV по задачам или моделям за любой период. Корпоративный тариф добавляет ежемесячное выставление счетов с отсрочкой платежа.
Для каждого типа моделей предусмотрен лимит на количество активных задач, а также лимиты на ключ и ограниченная очередь. Справедливый планировщик распределяет задачи между ключами по принципу карусели, поэтому всплеск из 200 задач у одного клиента никогда не заблокирует выполнение одиночной задачи другого. Дополнительные задачи встают в очередь, а не отклоняются, а в корпоративном тарифе лимиты увеличиваются в соответствии с вашей пропускной способностью.
Запросы регулируются квотами на ключ и на организацию. Значения по умолчанию — это базовый уровень; параллелизм, частота запросов, глубина очереди и емкость для каждой модели — это параметры, которые мы можем мгновенно изменить для организации без необходимости повторного развертывания или создания новых ключей.
Вы получаете чистую ошибку 429 с сигналом о перегрузке — никаких «тихих» сбоев. Задачи, которые уже были приняты, продолжают обрабатываться в очереди; вы можете замедлить отправку новых запросов или попросить нас повысить лимит.
Асинхронно. Отправка возвращает ответ за миллисекунды с идентификатором задачи. Затем вы можете либо опрашивать эндпоинт генерации, либо настроить подписанный вебхук, который отправит результат, как только он будет готов.
Терминальные события содержат HMAC-подпись, которую вы проверяете с помощью секрета вашей организации, и в случае сбоя они отправляются повторно. Таким образом, вы можете полностью отказаться от опроса и при этом никогда не пропустить результат.
Встроенная система обнаружения злоупотреблений отслеживает каждый ключ на предмет резких скачков объема и скорости запросов, а также активности из незнакомых стран, и мгновенно оповещает вашу команду по электронной почте и в консоли, если что-то выглядит подозрительно. Вы можете отозвать ключ в один клик, а лимиты расходов гарантируют, что масштаб ущерба будет ограничен еще до того, как вы отреагируете.
Да. Вы можете предоставить участнику доступ к консоли с ограниченной областью видимости — он сможет управлять только своими ключами и видеть только свою статистику использования, но не биллинг организации или ключи других участников. Владельцы и администраторы видят всё.
API активируется для каждой организации отдельно. Ваш аккаунт-менеджер включает его и устанавливает лимиты; после этого владельцы могут самостоятельно создавать ключи, просматривать документацию, статистику использования и счета в консоли. Большинство команд начинают использовать рабочие модели в тот же день.
Начало работы
Доступ предоставляется для каждой организации.
API доступен для корпоративных организаций. Как только ваша организация получит доступ, владельцы и администраторы смогут управлять всем через панель управления.
01
Получите доступ
Ваш аккаунт-менеджер откроет доступ к API для вашей организации и настроит выделенный пул кредитов.
02
Создайте ключи, изучите документацию
Создавайте API-ключи с ограниченными правами для своих разработчиков в консоли — и читайте полную интерактивную документацию с примерами для копирования.
03
Запускайте
Отправляйте запросы, опрашивайте статус и выводите результат. Следите за использованием и обновлением биллинга в реальном времени в консоли по мере генерации контента.