Saltar al contenido

Migrar desde RapidAPI

Si llamas a la API Signet QR a través de RapidAPI, no se rompe nada. El canal del marketplace sigue exactamente igual: la misma URL, la misma cabecera de autenticación, la misma estructura JSON y el mismo SLA.

Lo que ha cambiado es que el mismo motor impulsa ahora también un sitio para consumidores en qr-branding.com, con paquetes de créditos de pago único. Puedes quedarte en el marketplace, cambiarte o usar los dos.

Lo que no cambia

  • URL: api.qr-branding.com (CNAME a la misma Azure Function App signetqr-core).
  • Autenticación: cabecera X-RapidAPI-Proxy-Secret.
  • Endpoints: todas las rutas a las que ya llamabas.
  • Estructura de los cuerpos: QrConfig y AiQrRequest no se han tocado.
  • Estructura de las respuestas: idéntica.
  • Límites de peticiones: los mismos topes de los planes de RapidAPI.
  • Facturación: sigue siendo con el modelo de suscripción mensual / pago por llamada de RapidAPI.

Lo nuevo

  • Una segunda vía de autenticación para el sitio de consumo: cabeceras internas firmadas con HMAC (X-Internal-Service-Secret + X-Internal-Signature). No las verás: las pone en el servidor el BFF de Next.js.
  • Un endpoint de IA en el servidor, /api/qr/ai/generate/server, que no te pide tu propia llmApiKey. Solo está disponible para los clientes del sitio de consumo. Los clientes del marketplace siguen usando /api/qr/ai/generate con su clave.
  • Una caché de prompts de 30 días (Upstash Redis). Repetir el mismo prompt + provider + model + creativity + style + strict devuelve la configuración en caché: sin llamada al LLM y sin coste de tokens.

Cuándo pasarte a los créditos de consumo

Probablemente te convenga cambiarte si:

  • Haces menos de 200 generaciones con IA al mes (Starter, a 9 $ de pago único, sale más barato que un plan mensual).
  • Te has cansado de aportar tus propias claves de LLM y quieres un LLM en el servidor con un precio fijo por crédito.
  • Quieres QR dinámicos con estadísticas (desde 1 gratis con cuenta) o acceso a la API incluido (solo en Studio).

Probablemente te convenga quedarte en el marketplace si:

  • Haces más de 1500 generaciones con IA al mes con un volumen constante (la suscripción sale mejor que los paquetes).
  • Ya tienes una integración con RapidAPI con herramientas, conciliación de facturación, etc.
  • Quieres elegir entre OpenAI/Anthropic/Cohere/Mistral: el endpoint del marketplace te deja escoger.

Uso en paralelo

Nada te impide usar los dos canales a la vez. Las llamadas del marketplace van a api.qr-branding.com y el flujo del sitio de consumo va a qr-branding.com/api/internal/.... El mismo motor, dos contadores de facturación y ningún conflicto.

Si tienes dudas sobre si migrar, responde a tu último recibo: nos llega a nosotros.