La API de renderizado AI de Graydient
Si estás creando una app, herramienta interna o pipeline de render, Graydient te ofrece modelos abiertos de imagen, video y LLM en GPUs dedicadas, detrás de una API, a un precio mensual fijo.
Qué plan lo incluye
La API personal viene solo con Video Max. Images y Video Plus no incluyen acceso API. Puedes actualizar, degradar o cancelar en cualquier momento en el portal de facturación, con cargos prorrateados. Los precios del plan Business y API están en business.graydient.ai.
La API personal es una clave para un usuario humano, y no se permite tráfico automatizado en ningún plan personal. Eso significa no bots, scripts, programadores, trabajos por lotes, scrapers, apps multiusuario ni acceso revendidos. Tiene límite de tasa: mantén aproximadamente una llamada cada 10 segundos. Las claves que envíen tráfico automatizado o excesivo se revocan sin aviso.
Crear un producto multiusuario o marca blanca
Usuarios virtuales y login marca blanca son funciones de nivel empresarial para apps desplegadas, es decir, productos con muchos usuarios. Funcionan con la API personal, así que puedes construir y probar flujos multiusuario y marca blanca en Video Max durante el desarrollo.
Para lanzar un producto multiusuario, tráfico automatizado o acceso revendidos necesitas el plan Business: un servidor GPU dedicado. business.graydient.ai explica lo que incluye, lista precios y lo vende.
| API personal (Video Max) | Despliegue empresarial | |
|---|---|---|
| Usuarios | Un usuario (tú) | Usuarios de tu producto |
| Reventa | No permitido | Permitido |
| Usuarios virtuales e inicio de sesión con marca blanca | Construir y probar | Poner en producción |
| Cómo obtenerlo | Suscribirse a Video Max | Servidor GPU dedicado o acuerdo comercial |
Cómo funciona la API
La versión actual es V3, en https://cloud.graydient.ai/api/v3/. Sigue la especificación JSON:API: envía y acepta application/vnd.api+json, autentícate con un token Bearer HTTP estándar desde tu página de tokens API, y lee resultados desde un objeto data con un miembro attributes.
El renderizado es asíncrono. Envías un POST a POST /api/v3/render/ con un prompt y un callback_url obligatorio. Graydient responde de inmediato con un render_hash más tiempos estimados de espera y renderizado. Cuando el trabajo termina, hace un POST con los resultados a tu webhook. Los campos opcionales incluyen:
- error_url: un webhook para fallos
- init_image y mask_image: para imagen a imagen y repintado
- placeholders: URLs de imágenes nombradas para modos ControlNet o adaptadores IP
- progressive_return: un callback por imagen
- session_id: correlaciona renders con tus propios usuarios
Los flujos de trabajo se ejecutan por el mismo endpoint con un comando workflow en el prompt.
Estado sin sondeo: GET GET /api/v3/render/{render_hash} devuelve el estado de un render, pero la documentación pide no hacer polling. Usa el webhook o el stream WebSocket en wss://cloud.graydient.ai/render-events/{render_hash}, que envía eventos started, image_done, done y error.
Otras familias de endpoints
- Chat: chat LLM con una persona. Las respuestas van a un callback o vuelven en línea con sync: true, y los modelos de visión aceptan image_url.
- Conceptos: lista modelos y LoRAs disponibles.
- Workflows: lista flujos de trabajo y qué soporta cada uno, como txt2img, img2img, txt2vid e img2vid.
- Base de conocimiento: crea un dominio, añade hechos, rastrea URLs, luego busca o chatea.
- Skills: convierte solicitudes en lenguaje natural en comandos workflow.
- Usuarios virtuales: asigna tus usuarios finales a registros en tu cuenta. Construye y prueba con la API personal, luego ponlo en producción en un despliegue empresarial.
Referencia completa: documentación de la API. La documentación dice que aún están en desarrollo.
Casos de uso típicos
- Impulsar tu propia app: usa Graydient como backend de render para funciones de imagen, video o chat. Desarrolla en la API personal, luego pasa a un despliegue empresarial cuando lleguen usuarios reales.
- Usar tus modelos alojados: renderiza con las LoRAs y checkpoints que tengas instalados. Ver alberga tus propios modelos de IA.
- Ejecutar flujos de trabajo estilo ComfyAPI remotamente: llama a flujos mapeados desde tu propio código.
- Imágenes de producto y catálogo: mejora, edita o cambia el estilo de imágenes desde un pipeline, dentro del límite de tasa de la API personal.
- Renderizado por lotes: para lotes sostenidos y de alto volumen, usa un servidor GPU dedicado en lugar de la API personal.
- Chat con base de conocimiento: crea un asistente de soporte o documentación con la base de conocimiento y endpoints de chat.
Servidores GPU dedicados
Si planeas ejecutar tráfico automatizado, un producto multiusuario, acceso API revendidos o renderizados por lotes todo el día, necesitas el plan Business: un servidor GPU dedicado, con tu propia máquina y sin cola compartida. Precios, lo que incluye y el formulario de pedido están en business.graydient.ai.
El precio por renderizado para un servidor dedicado, video incluido, está listado en business.graydient.ai. Ese precio por renderizado aplica solo al plan Business. Images, Video Plus y Video Max mantienen tarifa fija sin cargos por renderizado.
No se permite tráfico automatizado en los planes personales. Images, Video Plus y Video Max son planes tarifa fija para un usuario humano, y las claves que envíen tráfico automatizado se revocan.
Primeros pasos
- Suscríbete a Video Max. Puedes cambiar o cancelar tu plan en cualquier momento en el portal de facturación.
- Crea un token en tu página de tokens API.
- Lee la documentación de la API y busca en GitHub ejemplos de uso de la API Graydient.
- Configura un endpoint webhook, luego envía tu primera solicitud de render.
- Haz espejo y miniaturas de las imágenes resultantes antes de mostrarlas a tus usuarios, como recomienda la documentación.
Soporte API disponible por email en info@graydient.ai. Todo uso está sujeto a la política de uso aceptable y los términos de uso.