02Cómo empezar
Conexión con IANuevo
Dale al asistente nuestra documentación y escribirá la integración por ti. Cada página tiene una versión en texto, y toda la documentación está en un solo archivo.
Cómo dar la documentación al asistente
Elige la forma que te resulte más cómoda. Todas funcionan con cualquier asistente: ChatGPT, Claude, Cursor y otros.
- Copiar para IA
- El botón situado sobre el título de cada página copia su texto al portapapeles en formato Markdown. Pega el texto en el chat y el asistente verá la misma página que tú.
- Abrir en ChatGPT o Claude
- Dos botones, uno junto al otro, abren el chat y le pasan de inmediato la dirección de la página en formato
.md. - Página en .md
- Añade
.mda la dirección de cualquier página de la documentación y obtendrás texto limpio, sin maquetación, por ejemplorendergrid.io/.es/ docs/ quickstart.md - llms.txt
- Lista de todas las páginas con una línea sobre cada una. Con ella, el asistente elige por sí mismo qué leer.
- llms-full.txt
- Toda la documentación en un solo archivo, para un asistente que necesita saberlo todo de una vez.
Empieza por la página «Inicio rápido»: basta para obtener la primera imagen. El resto, el asistente lo leerá siguiendo los enlaces de esa página.
Prompt listo para el asistente
Copia el texto, añade tu tarea y envíaselo al asistente. Ya incluye las reglas que más se suelen olvidar.
Conecta la generación de imágenes en mi proyecto mediante la API de Rendergrid. Documentación: https://rendergrid.io/ llms.txt Texto completo: https:// rendergrid.io/llms-full.txt Reglas: - lee la clave de la variable de entorno RENDERGRID_API_KEY y no la pongas en el código; - añade X-Idempotency-Key a cada solicitud de generación y guárdalo para los reintentos; - consulta el estado de la tarea como máximo una vez cada 5 segundos o recibe un webhook; - guarda enseguida la imagen de result_urls por tu parte: el enlace dura un día; - ante las respuestas 429 y 503, espera los segundos indicados en Retry-After.
Qué archivos tiene la documentación
| Dirección | Contenido | Cuándo usarlo |
|---|---|---|
/llms.txt | Lista de páginas con descripciones breves | Primer contacto, buscar la página que necesitas |
/llms-full.txt | Todo el texto de la documentación | El asistente debe saberlo todo sin seguir enlaces |
/es/ | Una página en Markdown | Una pregunta puntual: webhooks, errores, límites |
/openapi.json | Descripción de todos los endpoints de la API | Generar un cliente — página de OpenAPI |
/skills/ | Skill para Claude Code, en inglés | Trabajas en Claude Code — sección «Skills» |
/skills/ | Regla para Cursor, en inglés | Trabajas en Cursor — sección «Skills» |
Los archivos se actualizan junto con la documentación. La fecha de la última actualización figura en cada página, y la lista de cambios, en la sección «Novedades».
El archivo AGENTS.md para tu proyecto
Coloca este archivo en la raíz del repositorio. Muchos asistentes de código lo leen por sí solos y siguen las reglas sin esperar recordatorios.
## Rendergrid API - Dirección base: https://api.rendergrid.io/ api/ public/ v1 - Autorización: encabezado `Authorization: Bearer $RENDERGRID_API_KEY`. La clave va solo en una variable de entorno, nunca en el código ni en los registros. - Crear una imagen: `POST /images/ generate` -> 202 {id, status, task_id, cost}. - Obtener el resultado: `GET /creations/ {id}`, como máximo una vez cada 5 segundos. Estados: queued, processing, completed, failed. - Reintentos: un `X-Idempotency-Key` por operación; al reintentar, la misma clave. Una imagen nueva, una clave nueva. - Errores: consulta `error.code`. Con 429 y 503, espera `Retry-After`. - Los archivos de resultado se conservan un día: descárgalos de inmediato. - Documentación: https:// rendergrid.io/ llms.txt
Servidor MCP
MCP conecta Rendergrid con el asistente como un conjunto de herramientas: el asistente crea la imagen por sí solo, espera el resultado y comprueba el saldo. Sirve para Claude Desktop, Cursor y otros programas compatibles con MCP. Hay dos formas de conectarse; las herramientas y los precios son los mismos en ambas.
Servidor remoto. El programa se conecta con nosotros en la dirección https:// (también https://) y envía tu clave de API en el encabezado Authorization: Bearer o X-API-Key. No hay que instalar nada. Una solicitud sin clave recibe 401.
{
"mcpServers": {
"rendergrid": {
"url": "https://Puente local. Si el programa no sabe conectarse por dirección, ejecuta el paquete @rendergrid/mcp con npx: hace falta Node.js 22+. El puente lee la clave de una variable de entorno.
{
"mcpServers": {
"rendergrid": {
"command": "npx",
"args": ["-y", "@rendergrid/mcp"],
"env": { "RENDERGRID_API_KEY": "rg_live_…" }
}
}
}Sustituye rg_live_… por tu clave: las variables de entorno no se sustituyen en este archivo.
| Herramienta | Qué hace | Endpoint de la API |
|---|---|---|
generate_image | Crea una imagen y espera el resultado hasta 45 segundos | POST /images/ |
get_creation | Devuelve el estado y los enlaces a los archivos; si la tarea sigue en curso, espera hasta 45 segundos | GET /creations/ |
upload_image | Sube una imagen de referencia para editar: PNG, JPEG o WebP de hasta 25 MiB | POST /uploads |
list_models | Muestra los modelos y los precios de tu cuenta | GET /models |
get_balance | Muestra el importe disponible | GET /balance |
generate_image espera el resultado hasta 45 segundos. Si en ese tiempo la imagen no está lista, la herramienta devuelve el id de la tarea y la sugerencia de llamar a get_creation.
Llama a get_creation con ese id, no más de una vez cada 5 segundos: también espera hasta 45 segundos. No ejecutes generate_image de nuevo — es una solicitud nueva y un cargo nuevo.
El asistente gasta tu saldo: por cada imagen se hace el cargo de su precio, igual que en una solicitud normal.
Crea una clave aparte solo para el asistente: puedes revocarla en cualquier momento sin tocar las demás integraciones. Fija a la clave un límite mensual de gasto: es un límite estricto para esa clave (más información). No añadas al repositorio el archivo de configuración donde está la clave.
Skills para Claude Code y Cursor
Una skill es una instrucción lista para un asistente que escribe código: cómo llamar a la API de Rendergrid, qué campos hacen falta, cómo obtener el resultado y qué hacer ante los errores. Descarga el archivo y colócalo en tu proyecto: el asistente recogerá las reglas por sí solo. Los archivos están escritos en inglés: los lee un modelo, no una persona.
- Claude Code
- El archivo
/skills/. Colócalo enclaude-code/ SKILL.md .claude/skills/rendergrid/SKILL.mdde tu proyecto. - Cursor
- El archivo
/skills/. Colócalo encursor/ rendergrid.mdc .cursor/rules/rendergrid.mdcde tu proyecto.
Las skills se elaboran a partir de esta documentación y se actualizan con ella. No escribas la clave en el archivo: deja que el asistente la lea de la variable de entorno RENDERGRID_API_KEY.
Qué no dar al asistente
- La clave de API y el secreto de los webhooks. Pide al asistente que los lea de variables de entorno y no pegues los valores en el chat.
- Los datos de los clientes. Para los ejemplos, usa datos inventados:
you@example.com,5b0214ae-9e39-460a-820a-f6ae3e24400b. - La confianza ciega en el código. Contrasta lo que ha escrito el asistente con esta documentación: sobre todo la clave de idempotencia, el intervalo del sondeo y la comprobación de la firma del webhook.
Preguntas frecuentes
¿Basta con dar al asistente el enlace a la documentación?
rendergrid.io/. Si no sabe, pulsa «Copiar para IA» y pega el texto de la página en el chat.¿Es seguro dar la clave al asistente?
RENDERGRID_API_KEY y no pegues el valor en el chat.¿Se hace un cargo al trabajar con MCP?
¿Qué hacer si la imagen no estuvo lista en 45 segundos?
generate_image devuelve el id de la tarea y la sugerencia de llamar a get_creation. Llama a get_creation con ese id en lugar de lanzar la generación otra vez: una solicitud nueva supone un cargo nuevo.