Pular para o conteúdo

Migrando da RapidAPI

Se você vinha chamando a Signet QR API pela RapidAPI, nada quebra. O canal do marketplace está exatamente como antes — mesma URL, mesmo cabeçalho de autenticação, mesmo formato de JSON, mesmo SLA.

O que mudou é que o mesmo motor agora também alimenta um site para consumidores em qr-branding.com, com pacotes de créditos de pagamento único. Você pode continuar no marketplace, migrar ou usar os dois.

O que continua igual

  • URL: api.qr-branding.com (CNAME para a mesma Azure Function App signetqr-core).
  • Autenticação: cabeçalho X-RapidAPI-Proxy-Secret.
  • Endpoints: todas as rotas que você já chamava.
  • Formatos do corpo: QrConfig e AiQrRequest não foram alterados.
  • Formatos de resposta: idênticos.
  • Limites de requisições: os mesmos tetos dos planos da RapidAPI.
  • Cobrança: continua pelo modelo de assinatura mensal / por chamada da RapidAPI.

O que há de novo

  • Um segundo caminho de autenticação para o site de consumidores: cabeçalhos internos assinados com HMAC (X-Internal-Service-Secret + X-Internal-Signature). Você não vai vê-los — eles são definidos no servidor pelo BFF Next.js.
  • Um endpoint de IA no servidor, /api/qr/ai/generate/server, que não exige que você forneça a sua própria llmApiKey. Disponível só para clientes do site de consumidores. Os clientes do marketplace continuam usando /api/qr/ai/generate com a sua chave.
  • Um cache de prompts de 30 dias (Upstash Redis). Executar de novo o mesmo prompt + provider + model + creativity + style + strict devolve a configuração em cache — sem chamada ao LLM, sem custo de tokens.

Quando migrar para os créditos de consumidor

Provavelmente vale a pena migrar se:

  • Você faz menos de 200 gerações com IA por mês (o Starter, com pagamento único de $9, sai mais barato que um plano mensal).
  • Você cansou de trazer as suas próprias chaves de LLM e quer um LLM no servidor com preço fixo por crédito.
  • Você quer QRs dinâmicos com estatísticas (a partir de 1 grátis com conta) ou acesso à API incluído (só no Studio).

Provavelmente vale a pena continuar no marketplace se:

  • Você faz mais de 1500 gerações com IA por mês com volume constante (a assinatura sai melhor que os pacotes).
  • Você já tem uma integração com a RapidAPI, com ferramentas, conciliação de cobrança etc.
  • Você quer escolher entre OpenAI/Anthropic/Cohere/Mistral — o endpoint do marketplace permite escolher.

Uso lado a lado

Nada impede que você use os dois canais em paralelo. As chamadas do marketplace vão para api.qr-branding.com; o fluxo do site de consumidores vai para qr-branding.com/api/internal/.... Mesmo motor, dois medidores de cobrança, zero conflito.

Se tiver dúvidas sobre migrar ou não, responda ao seu último recibo — ele chega até nós.