API рендера Graydient AI
Если вы создаёте приложение, внутренний инструмент или конвейер рендера, Graydient предоставляет открытые модели изображений, видео и LLM на выделенных GPU через единый API по фиксированной ежемесячной цене.
В каком плане доступно
Личный API доступен только с Video Max. Images и Video Plus не включают доступ к API. Вы можете повысить, понизить или отменить подписку в любое время в портал оплаты с пропорциональным расчетом. Цены на бизнес-план и API на business.graydient.ai.
Личный API — это ключ для одного человека, и автоматический трафик не разрешён ни в одном личном плане. Это значит никаких ботов, скриптов, планировщиков, пакетных заданий, скрейперов, мультипользовательских приложений или перепродажи доступа. Ограничение скорости: примерно один вызов каждые 10 секунд. Ключи, отправляющие автоматический или чрезмерный трафик, блокируются без предупреждения.
Создание продукта для нескольких пользователей или с белым лейблом
Виртуальные пользователи и вход с белым лейблом — функции бизнес-уровня для развернутых приложений с множеством пользователей. Они работают на личном API, так что вы можете создавать и тестировать много-пользовательские и бело-лейбловые сценарии на Video Max во время разработки.
Для запуска мультипользовательского продукта, автоматического трафика или перепродажи нужен бизнес-план: выделенный GPU-сервер. business.graydient.ai объясняет, что включено, показывает цены и продаёт его.
| Личный API (Video Max) | Бизнес-развертывание | |
|---|---|---|
| Пользователи | Один пользователь (вы) | Пользователи вашего продукта |
| Перепродажа | Не разрешено | Разрешено |
| Виртуальные пользователи и вход под чужим брендом | Создавать и тестировать | Запуск в продакшен |
| Как получить | Подписаться на Video Max | Выделенный GPU сервер или бизнес-соглашение |
Как работает API
Текущая версия — V3, на https://cloud.graydient.ai/api/v3/. Она следует спецификации JSON:API: отправляйте и принимайте application/vnd.api+json, аутентифицируйтесь стандартным HTTP Bearer токеном с вашей страницы API токенов и читайте результаты из объекта data с атрибутом attributes.
Рендеринг асинхронный. Вы отправляете POST на POST /api/v3/render/ с промптом и обязательным callback_url. Graydient сразу отвечает render_hash и оценками времени ожидания и рендеринга. Когда задача завершена, он POST отправляет результаты на ваш вебхук. Дополнительные поля:
- error_url: вебхук для ошибок
- init_image и mask_image: для image-to-image и инпейнтинга
- placeholders: именованные URL изображений для режимов ControlNet или IP адаптеров
- progressive_return: один callback на каждое изображение
- session_id: связывать рендеры с вашими пользователями
Рабочие процессы запускаются через тот же эндпоинт с командой workflow в промпте.
Статус без опроса: GET GET /api/v3/render/{render_hash} возвращает статус рендера, но в документации просят не опрашивать его. Используйте вебхук или WebSocket поток на wss://cloud.graydient.ai/render-events/{render_hash}, который отправляет события started, image_done, done и error.
Другие семейства эндпоинтов
- Чат: LLM чат с персоной. Ответы идут на callback или возвращаются inline с sync: true, а визуальные модели принимают image_url.
- Концепты: список доступных моделей и LoRA.
- Рабочие процессы: список workflow и что каждый поддерживает, например txt2img, img2img, txt2vid и img2vid.
- База знаний: создавайте домен, добавляйте факты, сканируйте URL, затем ищите или общайтесь.
- Навыки: превращайте запросы на естественном языке в команды workflow.
- Виртуальные пользователи: сопоставляйте ваших конечных пользователей с записями в вашем аккаунте. Создавайте и тестируйте на личном API, затем запускайте в продакшен на бизнес-развертывании.
Полная справка: документация API. Документация говорит, что разработка продолжается.
Типичные случаи использования
- Использование в собственном приложении: используйте Graydient как бэкенд рендеринга для функций изображений, видео или чата. Разрабатывайте на личном API, затем переходите на бизнес-развертывание при появлении реальных пользователей.
- Использование ваших размещённых моделей: рендерьте с помощью установленных LoRA и чекпоинтов. Смотрите размещайте свои AI модели.
- Удалённый запуск рабочих процессов в стиле ComfyAPI: вызывайте отображённые рабочие процессы из своего кода.
- Изображения для продуктов и каталогов: увеличивайте, редактируйте или меняйте стиль изображений из пайплайна в рамках лимита личного API.
- Пакетный рендеринг: для длительных и больших объёмов используйте выделенный GPU сервер вместо личного API.
- Чат на базе знаний: создавайте помощника поддержки или документации на базе базы знаний и эндпоинтов чата.
Выделенные GPU серверы
Если вы планируете запускать автоматический трафик, мультипользовательский продукт, перепродавать доступ к API или делать пакетный рендеринг весь день, вам нужен бизнес-план: выделенный GPU-сервер с вашей собственной машиной и без общей очереди. Цены, что включено и форма заказа на business.graydient.ai.
Цены за рендеринг на выделенном сервере, включая видео, указаны на business.graydient.ai. Эта цена за рендеринг применяется только к бизнес-плану. Images, Video Plus и Video Max остаются с фиксированной оплатой без платы за рендеринг.
Автоматический трафик не разрешён в личных планах. Images, Video Plus и Video Max — это планы с фиксированной оплатой для одного человека, и ключи, отправляющие автоматический трафик, блокируются.
Начало работы
- Подпишитесь на Video Max. Вы можете изменить или отменить план в любое время в портал оплаты.
- Создайте токен на странице API токенов.
- Прочитайте документация API и посмотрите на GitHub примеры использования Graydient API.
- Настройте вебхук и отправьте первый запрос на рендер.
- Делайте зеркальные копии и миниатюры результатов перед показом пользователям, как рекомендует документация.
Поддержка API доступна по электронной почте info@graydient.ai. Использование регулируется политика приемлемого использования и условия использования.