API de QR Branding
La API de códigos QR más personalizable que existe. Genera códigos QR impactantes, con tu marca y conformes a ISO 18004, con 37 formas de módulo, 118 plantillas, diseño asistido por IA y 5 formatos de salida.
Suscríbete en RapidAPI: rapidapi.com/quartzondev/api/qr-branding. Los planes y las cuotas figuran en la página de RapidAPI.
Inicio rápido
1. Genera un código QR personalizado
curl -X POST "https://qr-branding.p.rapidapi.com/api/qr/generate" \
-H "Content-Type: application/json" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: qr-branding.p.rapidapi.com" \
-d '{
"content": "https://example.com",
"primaryColor": "#1a1a2e",
"backgroundColor": "#FFFFFF",
"moduleShape": "circle",
"fileFormat": "png",
"outputWidth": 512,
"eccLevel": "H"
}'
Respuesta:
{
"success": true,
"qrBase64": "iVBORw0KGgoAAAANSUhEUg...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 15234
}
2. Genera a partir de una plantilla
curl -X POST "https://qr-branding.p.rapidapi.com/api/qr/templates/cyber-neon" \
-H "Content-Type: application/json" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: qr-branding.p.rapidapi.com" \
-d '{
"content": "https://mywebsite.com",
"outputWidth": 600
}'
3. Código QR diseñado con IA
curl -X POST "https://qr-branding.p.rapidapi.com/api/qr/ai/generate" \
-H "Content-Type: application/json" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: qr-branding.p.rapidapi.com" \
-d '{
"prompt": "A luxurious gold and black QR code with rounded modules and a subtle glow effect, suitable for a premium brand",
"content": "https://premium-brand.com",
"llmProvider": "openai",
"llmApiKey": "sk-your-openai-key",
"creativity": 0.7,
"strictScannability": true,
"stylePreset": "luxury"
}'
Respuesta:
{
"success": true,
"qrBase64": "iVBORw0KGgoAAAANSUhEUg...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 28456,
"generatedConfig": { },
"aiExplanation": "I designed a premium QR code with...",
"llmProviderUsed": "openai",
"llmModelUsed": "gpt-6-luna"
}
Ejemplos de código
Python
import requests
url = "https://qr-branding.p.rapidapi.com/api/qr/generate"
headers = {
"Content-Type": "application/json",
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "qr-branding.p.rapidapi.com"
}
payload = {
"content": "https://example.com",
"primaryColor": "#FF6B35",
"moduleShape": "star",
"eccLevel": "H",
"outputWidth": 800,
"fileFormat": "png"
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()
if data["success"]:
import base64
img_bytes = base64.b64decode(data["qrBase64"])
with open("my_qr.png", "wb") as f:
f.write(img_bytes)
print(f"QR saved! Size: {data['sizeBytes']} bytes")
JavaScript (Node.js)
const response = await fetch(
"https://qr-branding.p.rapidapi.com/api/qr/generate",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "qr-branding.p.rapidapi.com",
},
body: JSON.stringify({
content: "https://example.com",
primaryColor: "#0066FF",
moduleShape: "hexagon",
eccLevel: "H",
outputWidth: 600,
fileFormat: "png",
}),
}
);
const data = await response.json();
if (data.success) {
const buffer = Buffer.from(data.qrBase64, "base64");
require("fs").writeFileSync("qr_code.png", buffer);
console.log(`QR generated: ${data.sizeBytes} bytes`);
}
Resumen de funciones
| Categoría | Detalles |
|---|---|
| Formas de módulo | 37: square, circle, diamond, star, heart, hexagon, leaf, cross, dot, mosaic, clipped, edgecut, pointed, pill, rounded, japanese, octagon, shield, arrow, drop + SVG personalizado |
| Plantillas | 118 prediseñadas en 28 categorías |
| Proveedores de IA | 9 proveedores de LLM y cualquier endpoint compatible con OpenAI (con tu propia clave), o IA gestionada sin clave |
| Formatos de salida | PNG, JPEG, SVG, PDF, WebP |
| Resolución máxima | 4096 × 4096 píxeles |
| Degradados | Lineal, radial y cónico, con paradas de color ilimitadas |
| Efectos visuales | Sombra, resplandor/neón, relieve/3D, ruido, desenfoque, difuminado de bordes, filtros de color |
| Logo | URL o Base64, formas circular/cuadrada/redondeada, sombra, tamaño personalizable |
| Textos superpuestos | Texto circular, banda central, bandas de llamada a la acción (CTA) |
| Marcos | Rectángulo, bocadillo, insignia, escudo, círculo |
| Corrección de errores | L (7%), M (15%), Q (25%), H (30%), según ISO 18004 |
| Utilidades de contenido | Generadores de cadenas WiFi, vCard y geolocalización |
| Imágenes de fondo | URL/Base64, modos de fusión, modos de ajuste, desenfoque |
| Módulos conectados | Uniones fluidas, en ángulo o redondeadas para diseños artísticos |
Categorías de plantillas (28)
Technology, Corporate, Social, Luxury, Nature, Artistic, Marketing, Events, Music, Fun, Background, Culture, Industry, Restaurant, Retail, Education, Travel, Automotive, Healthcare, Social Media, Art & Design, Business, Food & Drink, Finance, Health, Legal, Non-Profit, Real Estate.
Usa GET /api/qr/templates?category=luxury para filtrar por categoría.
Proveedores y modelos de IA
| Proveedor | Modelos |
|---|---|
| OpenAI | gpt-6-astra, gpt-6.1-sol, gpt-6-luna, gpt-6-sol, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-4.1-mini |
| Anthropic | claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-4-5 |
| gemini-3.1-pro-preview, gemini-3.8-flash, gemini-3.5-flash-lite, gemini-3.5-flash | |
| Mistral | mistral-large-latest, mistral-medium-latest, mistral-small-latest |
| Cohere | command-a-plus-05-2026, command-a-03-2025, command-a-reasoning-08-2025, command-r7b-12-2024 |
| Groq | openai/gpt-oss-120b, openai/gpt-oss-20b, llama-3.3-70b-versatile |
| xAI | grok-4.7, grok-4.3, grok-4.20-0309-non-reasoning |
| DeepSeek | deepseek-v4-pro, deepseek-flash |
| Qwen | qwen3.8-max, qwen3.7-plus, qwen3.8-flash |
| Local | Cualquier endpoint compatible con OpenAI (Ollama, LM Studio, vLLM); indica llmProvider: "local" y pasa localEndpoint |
Funciona cualquier ID de modelo que ofrezca tu proveedor; esta lista muestra los recomendados.
Nota: en
/api/qr/ai/generateaportas tu propia clave de API del proveedor de LLM que elijas y el proveedor te factura directamente; QR Branding no añade ningún recargo. En/api/qr/ai/generate-managedno hace falta clave de LLM: ejecutamos los modelos nosotros, y esas llamadas cuentan para la cuota independiente de IA gestionada de tu plan.
Endpoints
POST /api/qr/generate: generar un QR personalizado
Genera un código QR totalmente personalizable con más de 100 parámetros, entre ellos formas de módulo, degradados, efectos, logos, textos superpuestos, marcos y mucho más. Admite cuerpo JSON o multipart/form-data para subir el logo como archivo.
Cuerpo de la petición:
{
"content": "https://example.com",
"eccLevel": "H",
"pixelsPerModule": 20,
"outputWidth": 512,
"fileFormat": "png",
"quality": 90,
"responseType": "base64",
"backgroundColor": "#FFFFFF",
"transparentBackground": false,
"primaryColor": "#000000",
"secondaryColor": null,
"foregroundStyle": "solid",
"gradientType": "linear",
"gradientDirection": "vertical",
"gradientColors": ["#FF0000", "#0000FF"],
"gradientStops": [0.0, 1.0],
"gradientAngle": 0,
"qrShape": "square",
"moduleShape": "square",
"moduleScale": 0.85,
"moduleRotation": 0,
"moduleStyle": "solid",
"modulePattern": "standard",
"connectedStyle": "none",
"finderOuterShape": "square",
"finderInnerShape": "square",
"finderOuterColor": "#000000",
"finderInnerColor": "#000000",
"finderStyle": "standard",
"logoUrl": "https://example.com/logo.png",
"logoShape": "circle",
"logoSizePercent": 18,
"logoBorderWidth": 2,
"logoBorderColor": "#FFFFFF",
"logoShadow": true,
"logoBackground": "solid",
"ctaText": "SCAN ME"
}
Respuesta 200:
{
"success": true,
"qrBase64": "iVBORw0KGgoAAAANSUhEUg...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 15234
}
Respuesta 400:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed with 1 error.",
"details": [
{
"field": "moduleShape",
"code": "INVALID_MODULE_SHAPE",
"message": "Invalid module shape 'triangle'. Valid shapes: square, circle, diamond, star, heart, hexagon, leaf, cross, dot, mosaic, clipped, edgecut, pointed, pill, rounded, japanese, octagon, shield, arrow, drop."
}
]
}
}
POST /api/qr/ai/generate: generar un QR con IA
Describe en lenguaje natural tu código QR ideal y deja que la IA lo diseñe por ti. Admite 9 proveedores de LLM y cualquier endpoint compatible con OpenAI (local); se acepta cualquier ID de modelo que ofrezca tu proveedor. Aquí aportas tu propia clave de API del LLM; si prefieres no usar una, llama a POST /api/qr/ai/generate-managed (más abajo).
Cuerpo de la petición:
{
"prompt": "A modern tech-style QR code with hexagonal modules, a blue-to-purple gradient, subtle glow effect, and rounded finder patterns",
"content": "https://myapp.com",
"llmProvider": "openai",
"llmApiKey": "sk-your-api-key-here",
"llmModel": "gpt-6-luna",
"creativity": 0.7,
"strictScannability": true,
"stylePreset": "tech",
"fileFormat": "png",
"outputWidth": 800,
"logoUrl": "https://example.com/logo.png",
"ctaText": "Download App"
}
Respuesta 200:
{
"success": true,
"qrBase64": "iVBORw0KGgoAAAANSUhEUg...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 28456,
"generatedConfig": {
"content": "https://myapp.com",
"moduleShape": "hexagon",
"primaryColor": "#4A90D9",
"gradientColors": ["#4A90D9", "#7B2FF7"],
"gradientType": "linear",
"gradientDirection": "vertical",
"finderOuterShape": "roundedsquare",
"finderInnerShape": "circle",
"eccLevel": "H"
},
"aiExplanation": "I designed a tech-inspired QR code with hexagonal modules...",
"llmProviderUsed": "openai",
"llmModelUsed": "gpt-6-luna"
}
POST /api/qr/ai/generate-managed: IA gestionada (sin clave de LLM)
Mismo formato de petición que /api/qr/ai/generate, pero llmProvider, llmApiKey y llmModel se ignoran: no hace falta clave de LLM. El motor usa sus propios modelos con una cadena de respaldo (Groq → Gemini). Las llamadas cuentan para la cuota de IA gestionada de tu plan.
{
"prompt": "A luxurious gold and black QR with rounded modules and a subtle glow effect",
"content": "https://premium-brand.com",
"creativity": 0.7,
"strictScannability": true,
"stylePreset": "luxury",
"fileFormat": "png",
"outputWidth": 800
}
La respuesta tiene el mismo formato que /api/qr/ai/generate, con el campo adicional "managed": true.
GET /api/qr/ai/providers: obtener los proveedores de IA
Lista todos los proveedores de LLM admitidos y sus modelos disponibles para la generación de QR con IA.
Respuesta 200:
{
"success": true,
"count": 10,
"providers": [
{
"id": "openai",
"name": "OpenAI",
"defaultModel": "gpt-6-luna",
"availableModels": ["gpt-6-astra", "gpt-6.1-sol", "gpt-6-luna", "gpt-6-sol", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-4.1-mini"]
},
{
"id": "anthropic",
"name": "Anthropic",
"defaultModel": "claude-sonnet-5-5",
"availableModels": ["claude-fable-5-1", "claude-opus-5-5", "claude-sonnet-5-5", "claude-haiku-4-5"]
}
]
}
GET /api/qr/templates: listar plantillas
Explora 118 plantillas de códigos QR de diseño profesional en 28 categorías.
Parámetros de consulta:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
category | string | No | Filtra por categoría (p. ej., luxury, corporate, social) |
Respuesta 200:
{
"success": true,
"count": 118,
"categories": [
"Technology", "Corporate", "Social", "Luxury", "Nature",
"Artistic", "Marketing", "Events", "Music", "Fun"
],
"templates": [
{
"id": "cyber-neon",
"name": "Cyber Neon",
"category": "Technology",
"description": "Futuristic glowing neon style with diamond modules and vibrant cyan-pink gradient"
},
{
"id": "professional-blue",
"name": "Professional Blue",
"category": "Corporate",
"description": "Clean corporate style with blue gradient, ideal for business"
}
]
}
POST /api/qr/templates/{templateId}: generar a partir de una plantilla
Genera un código QR con una plantilla prediseñada. Se conserva el diseño visual de la plantilla; si quieres, puedes cambiar los ajustes de salida.
Parámetros de ruta:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
templateId | string | Sí | ID de la plantilla obtenido del endpoint de listado de plantillas (p. ej., cyber-neon) |
Cuerpo de la petición:
{
"content": "https://mywebsite.com",
"fileFormat": "png",
"responseType": "base64",
"outputWidth": 600,
"logoUrl": "https://example.com/logo.png",
"ctaText": "Visit Us"
}
Respuesta 200:
{
"success": true,
"qrBase64": "iVBORw0KGgoAAAANSUhEUg...",
"format": "png",
"contentType": "image/png",
"sizeBytes": 22100
}
POST /api/qr/content/wifi: generar una cadena WiFi
Genera una cadena de conexión WiFi para codificarla en un QR. A quien escanee el código QR se le ofrecerá conectarse automáticamente a la red.
Cuerpo de la petición:
{
"ssid": "MyNetwork",
"password": "MyP@ssw0rd!",
"encryption": "WPA",
"hidden": false
}
Respuesta 200:
{
"success": true,
"text": "WIFI:T:WPA;S:MyNetwork;P:MyP@ssw0rd!;H:false;;"
}
POST /api/qr/content/vcard: generar una cadena vCard
Genera una cadena de contacto vCard para codificarla en un QR. Al escanear el código QR, se ofrecerá guardar el contacto en el teléfono.
Cuerpo de la petición:
{
"firstName": "John",
"lastName": "Doe",
"phone": "+1-555-123-4567",
"email": "john.doe@example.com",
"org": "Acme Corp",
"url": "https://johndoe.com"
}
Respuesta 200:
{
"success": true,
"text": "BEGIN:VCARD\nVERSION:3.0\nN:Doe;John\nFN:John Doe\nTEL:+1-555-123-4567\nEMAIL:john.doe@example.com\nORG:Acme Corp\nURL:https://johndoe.com\nEND:VCARD"
}
POST /api/qr/content/geo: generar una cadena de geolocalización
Genera una URI de geolocalización para codificarla en un QR. Al escanear el código QR, la ubicación se abrirá en la app de mapas predeterminada.
Cuerpo de la petición:
{
"lat": 40.7128,
"lng": -74.0060
}
Respuesta 200:
{
"success": true,
"text": "geo:40.7128,-74.006"
}
POST /api/qr/scan-check: comprobar que un diseño se escanea
Simula cómo se lee un código impreso antes de mandarlo a la imprenta. Envía el mismo QrConfig que a /api/qr/generate (content es el único campo obligatorio): el motor renderiza ese diseño exacto y lo decodifica en 13 condiciones simuladas (baseline, small-print, far-away, slight-blur, strong-blur, dim-light, low-contrast, uneven-light, glare, noise, rotated, angle-30 y angle-40). Es una simulación, nunca una garantía: indica qué se lee de vuelta en esas condiciones, no que cualquier teléfono vaya a escanearlo. Los ajustes de salida (fileFormat, responseType, outputWidth, outputHeight, pixelsPerModule) se ignoran porque la comprobación genera su propio PNG.
Cuerpo de la petición:
{
"content": "https://example.com/menu",
"eccLevel": "H",
"primaryColor": "#1a1a2e",
"backgroundColor": "#FFFFFF",
"moduleShape": "circle",
"finderOuterShape": "roundedsquare"
}
Respuesta 200:
{
"success": true,
"grade": "good",
"symbolModules": 33,
"version": 4,
"smallestModulePx": 1.5,
"conditions": [
{ "id": "baseline", "core": true, "passed": true, "adaptiveReader": true, "globalReader": true },
{ "id": "small-print", "core": true, "passed": true, "adaptiveReader": true, "globalReader": true },
{ "id": "glare", "core": false, "passed": true, "adaptiveReader": true, "globalReader": false },
{ "id": "angle-40", "core": false, "passed": false, "adaptiveReader": false, "globalReader": false }
],
"sizes": [
{ "id": "table", "distanceCm": 40, "minSideMm": 55 },
{ "id": "wall", "distanceCm": 150, "minSideMm": 200 },
{ "id": "street", "distanceCm": 400, "minSideMm": 530 }
],
"designScore": 96,
"designWarnings": [],
"elapsedMs": 812
}
grade es excellent, good, fair o poor. Cada condición indica passed, core (obligatoria para una nota good) y cuál de los dos decodificadores del motor la leyó (adaptiveReader, globalReader; juntos dan el número de lectores, de 0 a 2). sizes da el lado mínimo de impresión en milímetros para leer desde una mesa (40 cm), una pared (1,5 m) y la calle (4 m); minSideMm es null si el diseño no se leyó a ninguna resolución probada. designScore es la puntuación estática de diseño ISO 18004 del motor (0–100) y designWarnings enumera los campos de QrConfig que marcaron esas reglas.
Errores: 400 validación (VALIDATION_ERROR, INVALID_JSON, MISSING_REQUIRED_FIELD) · 401 UNAUTHORIZED · 500 QR_GENERATION_FAILED.
GET /api/qr/templates/{templateId}/config: leer el diseño de una plantilla
Lee el diseño de una plantilla sin renderizar ningún código QR. config es el QrConfig completo de la plantilla: toma los campos que quieras, añade tu propio content y envía el resultado a /api/qr/generate para renderizar una versión retocada.
Parámetros de ruta:
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
templateId | string | Sí | ID de la plantilla obtenido del endpoint de listado de plantillas (p. ej., cyber-neon) |
Respuesta 200:
{
"success": true,
"id": "cyber-neon",
"name": "Cyber Neon",
"category": "Technology",
"description": "Futuristic glowing neon style with diamond modules and vibrant cyan-pink gradient",
"config": {
"eccLevel": "H",
"primaryColor": "#00f2ea",
"secondaryColor": "#FF7AA4",
"backgroundColor": "#0a0a12",
"foregroundStyle": "linearGradient",
"gradientDirection": "diagonal",
"moduleShape": "diamond",
"finderOuterShape": "roundedsquare",
"finderInnerShape": "diamond",
"logoSizePercent": 22
}
}
Errores: 404 TEMPLATE_NOT_FOUND si el id no existe.
POST /api/qr/poster: generar un póster listo para imprimir
Envuelve un diseño QR en un póster listo para imprimir: A4, A5, A6 (vertical) o US Letter, con titular, línea de instrucciones y pie de página opcionales, el logo del diseño, 3 mm de sangrado y marcas de corte. qr acepta exactamente el cuerpo de /api/qr/generate; su fileFormat y su responseType se ignoran porque el archivo lo decide el póster. El PDF es vectorial y mantiene la misma garantía de escaneo que /api/qr/generate; el PNG es para previsualizaciones.
Cuerpo de la petición:
{
"qr": {
"content": "https://example.com/menu",
"eccLevel": "H",
"primaryColor": "#1a1a2e",
"backgroundColor": "#FFFFFF",
"moduleShape": "circle"
},
"poster": {
"format": "a4",
"layout": "band",
"headline": "Scan the menu",
"instruction": "Point your camera at the code",
"footer": "example.com",
"showLogo": true,
"bleed": true,
"cropMarks": true,
"fileFormat": "pdf",
"responseType": "base64"
}
}
Opciones del póster:
| Parámetro | Tipo | Valor por defecto | Descripción |
|---|---|---|---|
format | string | a4 | Tamaño final: a4, a5, a6 (vertical) o letter (US Letter, vertical) |
layout | string | minimal | minimal, band (franja de cabecera en el color de acento), card (tarjeta con borde) o tent (atril plegable) |
headline | string | — | Titular grande encima del QR |
instruction | string | — | Línea corta bajo el QR (p. ej., «Apunta la cámara al código») |
footer | string | — | Línea pequeña de pie, p. ej. un sitio web o una URL corta |
showLogo | boolean | true | Dibuja el logo del diseño en la parte superior del póster |
bleed | boolean | false | Añade 3 mm de sangrado alrededor del recorte; los fondos y las franjas se prolongan hasta ahí |
cropMarks | boolean | false | Dibuja marcas de corte fuera del recorte |
accentColor | string | Color del CTA o de los módulos | Color de marca para el titular, la franja y el borde de la tarjeta; por defecto, el color del marco CTA y, si no hay, el color de los módulos |
fileFormat | string | pdf | pdf (vectorial, impresión) o png (ráster, previsualizaciones) |
dpi | integer | 150 | Resolución de un póster PNG, 36–300 ppp (se ignora en PDF) |
responseType | string | base64 | base64 (JSON, como /api/qr/generate) o binary (el archivo en sí) |
Respuesta 200:
{
"success": true,
"qrBase64": "JVBERi0xLjQKJcfsj6IK...",
"format": "pdf",
"contentType": "application/pdf",
"sizeBytes": 184320
}
Con "responseType": "binary" la respuesta es el archivo en sí (application/pdf o image/png).
Errores: 400 validación · 401 UNAUTHORIZED · 422 QR_UNSCANNABLE cuando el código no se puede leer de vuelta · 422 OUTPUT_TOO_COMPLEX cuando el PDF superaría los 20 MB · 500 QR_GENERATION_FAILED.
GET /api/ping: sonda de disponibilidad
Comprueba que la API responde sin consumir una generación.
Respuesta 200:
{
"status": "ok"
}
Errores: 429 cuando se supera el límite de sondas por IP (10 por minuto).
Gestión de errores
Todos los errores siguen un formato uniforme:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed with 2 errors.",
"details": [
{
"field": "primaryColor",
"code": "INVALID_COLOR_FORMAT",
"message": "Invalid color format. Use hex (#RRGGBB or #RRGGBBAA).",
"value": "not-a-color"
}
]
}
}
Códigos de error
Validación (400)
VALIDATION_ERROR · INVALID_JSON · MISSING_REQUIRED_FIELD · INVALID_FIELD_VALUE · INVALID_COLOR_FORMAT · INVALID_FILE_FORMAT · CONTENT_TOO_LONG · FILE_TOO_LARGE · INVALID_URL · INVALID_ECC_LEVEL · INVALID_MODULE_SHAPE · INVALID_GRADIENT_TYPE · INVALID_RESPONSE_TYPE · VALUE_OUT_OF_RANGE · MULTIPART_CONFIG_MISSING
Autenticación (401)
UNAUTHORIZED · INVALID_API_KEY · MISSING_API_KEY
No encontrado (404)
RESOURCE_NOT_FOUND · TEMPLATE_NOT_FOUND
Errores de IA/LLM (400/500)
INVALID_LLM_PROVIDER · INVALID_LLM_MODEL · LLM_API_KEY_INVALID · AI_GENERATION_FAILED · AI_CONFIG_INVALID · AI_REQUEST_TIMEOUT
Presupuesto de salida (422)
OUTPUT_TOO_COMPLEX — el diseño produciría un SVG o PDF de más de 20 MB o un lienzo de más de 5120 px por lado. Expórtalo en PNG, acorta el contenido o usa formas de módulo más sencillas
Capacidad (503)
SERVER_BUSY · AI_QUOTA_EXCEEDED (la IA gestionada se ha quedado sin cuota en todos los proveedores; vuelve a intentarlo más tarde)
Errores del servidor (500)
INTERNAL_ERROR · QR_GENERATION_FAILED · LOGO_LOAD_FAILED · BACKGROUND_LOAD_FAILED
Condiciones de uso
Al llamar a esta API a través del marketplace aceptas las Condiciones de RapidAPI y nuestras condiciones del marketplace: https://qr-branding.com/es/docs/rapidapi/terms (en vigor desde el 2026-10-07).
- La facturación y los planes los vende y factura RapidAPI. Cuotas, excesos, reembolsos y cancelaciones se gestionan en el portal de facturación de RapidAPI, no con nosotros.
- La autenticación la inyecta RapidAPI como cabecera
X-RapidAPI-Proxy-Secret. Mantén tuX-RapidAPI-Keyconfidencial y no la incluyas en código de cliente ni en repositorios públicos. - Cada petición cuenta para tu cuota, también las que terminan en error como
422 QR_UNSCANNABLE, porque RapidAPI mide llamadas, no resultados. - Garantía de escaneo: cada render se decodifica en el servidor antes de entregarse. Si un diseño no se puede leer, la API devuelve
422en lugar de una imagen. Eso verifica el archivo, no garantiza cualquier cámara a cualquier distancia. - Uso aceptable: nada ilícito, no compartir la clave más allá de tu plan, no intentar saltarse los límites ni la comprobación del proxy secret.
- Ley aplicable: España. El texto completo está en https://qr-branding.com/es/docs/rapidapi/terms