Vai al contenuto

Migrare da RapidAPI

Se finora hai chiamato l'API Signet QR tramite RapidAPI, non si rompe nulla. Il canale marketplace è esattamente com'era: stesso URL, stesso header di autenticazione, stessa struttura JSON, stesso SLA.

La novità è che lo stesso motore ora alimenta anche un sito consumer su qr-branding.com con pacchetti di crediti una tantum. Puoi restare sul marketplace, passare all'altro canale o usarli entrambi.

Cosa resta uguale

  • URL: api.qr-branding.com (CNAME verso la stessa Azure Function App signetqr-core).
  • Autenticazione: header X-RapidAPI-Proxy-Secret.
  • Endpoint: tutti i percorsi che chiamavi.
  • Strutture dei corpi: QrConfig e AiQrRequest restano invariati.
  • Strutture delle risposte: identiche.
  • Limiti di richieste: gli stessi tetti dei piani RapidAPI.
  • Fatturazione: sempre tramite l'abbonamento mensile / il modello a chiamata di RapidAPI.

Cosa c'è di nuovo

  • Un secondo percorso di autenticazione per il sito consumer: header interni firmati con HMAC (X-Internal-Service-Secret + X-Internal-Signature). Non li vedrai: li imposta lato server il BFF Next.js.
  • Un endpoint IA lato server /api/qr/ai/generate/server che non richiede di fornire la tua llmApiKey. Disponibile solo per i clienti del sito consumer. I clienti del marketplace continuano a usare /api/qr/ai/generate con la propria chiave.
  • Una cache dei prompt di 30 giorni (Upstash Redis). Rieseguire la stessa combinazione prompt + provider + model + creativity + style + strict restituisce la configurazione in cache: nessuna chiamata all'LLM, nessun costo in token.

Quando passare ai crediti consumer

Probabilmente ti conviene passare se:

  • Fai meno di 200 generazioni IA al mese (Starter a $9 una tantum costa meno di un piano mensile).
  • Sei stanco di usare le tue chiavi LLM e vuoi un LLM lato server con un prezzo fisso per credito.
  • Vuoi QR dinamici con statistiche (da 1 gratis con account) o l'accesso all'API incluso (solo con Studio).

Probabilmente ti conviene restare sul marketplace se:

  • Fai più di 1500 generazioni IA al mese con un volume costante (l'abbonamento conviene più dei pacchetti).
  • Hai già un'integrazione RapidAPI con strumenti, riconciliazione della fatturazione, ecc.
  • Vuoi scegliere tra OpenAI/Anthropic/Cohere/Mistral: l'endpoint del marketplace te lo permette.

Uso in parallelo

Nulla ti impedisce di usare entrambi i canali in parallelo. Le chiamate al marketplace vanno su api.qr-branding.com, il flusso del sito consumer passa da qr-branding.com/api/internal/.... Stesso motore, due contatori di fatturazione, zero conflitti.

Se hai dubbi sull'opportunità di migrare, rispondi alla tua ultima ricevuta: arriva a noi.