API рендера Graydient AI
Если вы создаёте приложение, внутренний инструмент или конвейер рендера, Graydient предоставляет открытые модели изображений, видео и LLM на выделенных GPU через единый API по фиксированной ежемесячной цене.
В каком плане доступно
Личный API доступен только в Video Max: $84 в месяц при годовой оплате ($999 в год) или $99.99 помесячно. В планах Images и Video Plus доступ к API отсутствует. Вы можете повысить, понизить или отменить подписку в любое время в портал оплаты с пропорциональным расчётом.
Личный API — это ключ для одного пользователя, не предназначенный для перепродажи. Он ограничен по частоте: примерно один вызов каждые 10 секунд, избегайте пакетной обработки. Ключи могут автоматически истекать при слишком большом количестве запросов.
Создание продукта для нескольких пользователей или с белым лейблом
Виртуальные пользователи и вход с белым лейблом — функции бизнес-уровня для развернутых приложений с множеством пользователей. Они работают на личном API, так что вы можете создавать и тестировать много-пользовательские и бело-лейбловые сценарии на Video Max во время разработки.
Для запуска много-пользовательского продукта или перепродажи доступа нужна бизнес-опция: выделенный сервер GPU или бизнес-соглашение. Для обсуждения бизнес-развертывания пишите на info@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 или делать пакетный рендеринг весь день, Graydient предлагает выделенный Video Max GPU сервер за $499.99 в месяц. Вы получаете собственную машину без очереди, можете запускать длительные задачи и устанавливать ограничения для клиентов по возможностям и времени в очереди. Можно подключать несколько серверов по мере роста, контракт требует уведомления за 30 дней без долгосрочных обязательств.
Цены рендеринга на выделенных серверах: рендеры на выделенном сервере стоят $0.02 за каждый, включая видео. Эта цена за рендер действует только для выделенного сервера. Планы Images, Video Plus и Video Max остаются с фиксированной ставкой без платы за рендер.
Чтобы арендовать, напишите на info@graydient.ai.
Начало работы
- Подпишитесь на Video Max. Вы можете изменить или отменить план в любое время в портал оплаты.
- Создайте токен на странице API токенов.
- Прочитайте документация API и посмотрите на GitHub примеры использования Graydient API.
- Настройте вебхук и отправьте первый запрос на рендер.
- Делайте зеркальные копии и миниатюры результатов перед показом пользователям, как рекомендует документация.
Поддержка API доступна по электронной почте info@graydient.ai. Использование регулируется политика приемлемого использования и условия использования.