A API de renderização AI Graydient
Se você está criando um app, uma ferramenta interna ou um pipeline de renderização, Graydient oferece modelos abertos de imagem, vídeo e LLM em GPUs dedicadas, por trás de uma única API, a um preço fixo mensal.
Qual plano inclui
A API pessoal vem apenas com Video Max. Images e Video Plus não incluem acesso à API. Você pode fazer upgrade, downgrade ou cancelar a qualquer momento no portal de cobrança, com cobrança proporcional. Preços do plano Business e API estão em business.graydient.ai.
A API pessoal é para um usuário humano, e tráfego automatizado não é permitido em nenhum plano pessoal. Isso significa sem bots, scripts, agendadores, trabalhos em lote, scrapers, apps multiusuário ou acesso revendido. Tem limite de taxa: mantenha cerca de uma chamada a cada 10 segundos. Chaves que enviam tráfego automatizado ou excessivo são revogadas sem aviso.
Criando um produto multiusuário ou white-label
Usuários virtuais e login white-label são recursos de nível empresarial para apps implantados, ou seja, produtos com muitos usuários. Funcionam na API pessoal, para que você possa construir e testar fluxos multiusuário e white-label no Video Max durante o desenvolvimento.
Para uso ao vivo com produto multiusuário, tráfego automatizado ou acesso revendido é necessário o plano Business: um servidor GPU dedicado. business.graydient.ai explica o que está incluído, lista preços e vende.
| API Pessoal (Video Max) | Implantação empresarial | |
|---|---|---|
| Usuários | Um usuário (você) | Usuários do seu produto |
| Revenda | Não permitido | Permitido |
| Usuários virtuais e login white-label | Construir e testar | Entrar no ar |
| Como obter | Assine o Video Max | Servidor GPU dedicado ou acordo comercial |
Como a API funciona
A versão atual é a V3, em https://cloud.graydient.ai/api/v3/. Ela segue a especificação JSON:API: envie e aceite application/vnd.api+json, autentique-se com um token HTTP Bearer padrão da sua página de tokens da API e leia os resultados de um objeto data com um membro attributes.
A renderização é assíncrona. Você faz um POST para POST /api/v3/render/ com um prompt e um callback_url obrigatório. Graydient responde imediatamente com um render_hash mais os tempos estimados de espera e renderização. Quando o trabalho termina, ele faz um POST dos resultados para seu webhook. Campos opcionais incluem:
- error_url: um webhook para falhas
- init_image e mask_image: para image-to-image e inpainting
- placeholders: URLs nomeadas de imagens para modos ControlNet ou adaptadores IP
- progressive_return: um callback por imagem
- session_id: correlacione renders com seus próprios usuários
Workflows rodam pelo mesmo endpoint com um comando workflow no prompt.
Status sem polling: GET GET /api/v3/render/{render_hash} retorna o status de um render, mas a documentação pede para não fazer polling. Use o webhook ou o stream WebSocket em wss://cloud.graydient.ai/render-events/{render_hash}, que envia eventos started, image_done, done e error.
Outras famílias de endpoints
- Chat: chat LLM com uma persona. Respostas vão para um callback ou retornam inline com sync: true, e modelos de visão aceitam image_url.
- Conceitos: lista modelos e LoRAs disponíveis.
- Workflows: lista workflows e o que cada um suporta, como txt2img, img2img, txt2vid e img2vid.
- Base de conhecimento: crie um domínio, adicione fatos, rastreie URLs e depois pesquise ou converse.
- Skills: transforme pedidos em linguagem natural em comandos de workflow.
- Usuários virtuais: mapeie seus usuários finais para registros na sua conta. Construa e teste com isso na API pessoal, depois entre no ar numa implantação comercial.
Referência completa: documentação da API. A documentação diz que ainda está em desenvolvimento.
Casos típicos de uso
- Alimentar seu próprio app: use Graydient como backend de renderização para recurso de imagem, vídeo ou chat. Desenvolva na API pessoal e depois migre para implantação comercial quando tiver usuários reais.
- Usar seus modelos hospedados: renderize com os LoRAs e checkpoints que você instalou. Veja hospede seus próprios modelos de IA.
- Executando fluxos de trabalho no estilo ComfyAPI remotamente: chame fluxos de trabalho mapeados a partir do seu próprio código.
- Imagens de produto e catálogo: aumente, edite ou modifique imagens de um pipeline, dentro do limite de taxa da API pessoal.
- Renderização em lote: para lotes contínuos e de alto volume, use um servidor GPU dedicado em vez da API pessoal.
- Chat da base de conhecimento: construa um assistente de suporte ou documentação nos endpoints de base de conhecimento e chat.
Servidores GPU dedicados
Se pretende rodar tráfego automatizado, produto multiusuário, acesso API revendido ou renderizações em lote o dia todo, precisa do plano Business: um servidor GPU dedicado, com sua própria máquina e sem fila compartilhada. Preços, inclusões e pedido estão em business.graydient.ai.
Preço por renderização para servidor dedicado, vídeo incluído, está listado em business.graydient.ai. Esse preço por renderização aplica-se apenas ao plano Business. Images, Video Plus e Video Max permanecem com tarifa fixa sem cobrança por renderização.
Tráfego automatizado não é permitido em planos pessoais. Images, Video Plus e Video Max são planos com tarifa fixa para um usuário humano, e chaves que enviam tráfego automatizado são revogadas.
Começando
- Assine o Video Max. Você pode mudar ou cancelar seu plano a qualquer momento no portal de cobrança.
- Crie um token na sua página de tokens da API.
- Leia a documentação da API e veja no GitHub exemplos de uso da API Graydient.
- Configure um endpoint webhook e envie sua primeira requisição de render.
- Espelhe e crie miniaturas das imagens de resultado antes de servir aos seus usuários, como a documentação recomenda.
Suporte à API disponível por email em info@graydient.ai. Todo uso está sujeito ao política de uso aceitável e aos termos de uso.