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 só com o Video Max: $84 por mês no plano anual ($999 cobrado anualmente) ou $99.99 mensal. 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ças proporcionais.
A API pessoal é uma chave para um usuário, não para revenda. Tem limite de taxa: mantenha cerca de uma chamada a cada 10 segundos e evite lotes. Chaves podem expirar automaticamente se muitas requisições forem enviadas.
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.
Lançar um produto multiusuário ao vivo, ou revender acesso, requer a opção empresarial: um servidor GPU dedicado ou um acordo comercial. Para discutir uma implantação empresarial, escreva para info@graydient.ai.
| 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 você planeja rodar um produto multiusuário, revender acesso à API ou renderizar lotes o dia todo, Graydient oferece um servidor GPU Video Max dedicado por $499.99 por mês. Você tem sua própria máquina sem fila, pode rodar trabalhos mais longos e definir limites para o que seus clientes podem fazer e quanto tempo seus slots de fila duram. Pode empilhar vários servidores conforme cresce, e o contrato pede aviso prévio de 30 dias, sem compromisso de longo prazo.
Preço de renderização em servidores dedicados: renders em servidor dedicado custam $0.02 cada, vídeo incluído. Esse preço por render aplica-se só ao servidor dedicado. Os planos Images, Video Plus e Video Max continuam com preço fixo, sem cobrança por render.
Para alugar um, escreva para info@graydient.ai.
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.