跳到正文

从 RapidAPI 迁移

如果你一直通过 RapidAPI 调用 Signet QR API,一切照常运行。市场渠道与以前完全相同:相同的 URL、相同的认证请求头、相同的 JSON 结构、相同的 SLA。

变化在于,同一个引擎现在还为 qr-branding.com 上的消费者网站提供支持,并提供一次性购买的额度包。你可以继续留在市场、切换过来,或者两者都用。

保持不变的内容

  • URL:api.qr-branding.com(CNAME 指向同一个 Azure Function App signetqr-core)。
  • 认证:X-RapidAPI-Proxy-Secret 请求头。
  • 端点:你一直在调用的所有路径。
  • 请求体结构:QrConfig 和 AiQrRequest 均未改动。
  • 响应结构:完全相同。
  • 速率限制:与 RapidAPI 套餐上限相同。
  • 计费:仍采用 RapidAPI 的月度订阅 / 按调用计费模式。

新增内容

  • 为消费者网站新增的第二条认证路径:经 HMAC 签名的内部请求头(X-Internal-Service-Secret + X-Internal-Signature)。你不会看到它们,它们由 Next.js BFF 在服务器端设置。
  • 服务器端 AI 端点 /api/qr/ai/generate/server,无需提供你自己的 llmApiKey。仅面向消费者网站的客户。市场客户继续使用自己的密钥调用 /api/qr/ai/generate。
  • 30 天提示词缓存(Upstash Redis)。重新运行相同的 prompt + provider + model + creativity + style + strict 会返回缓存的配置,不调用 LLM,也不产生 token 费用。

何时改用消费者额度

如果符合以下情况,你可能适合迁移:

  • 每月 AI 生成少于 200 次(一次性 $9 的 Starter 比月度套餐更便宜)。
  • 厌倦了自带 LLM 密钥,希望使用按额度统一计价的服务器端 LLM。
  • 希望使用带统计数据的动态 QR(注册账户即可免费获得 1 个)或包含 API 访问(仅限 Studio)。

如果符合以下情况,你可能更适合留在市场:

  • 每月稳定进行超过 1500 次 AI 生成(订阅比额度包更划算)。
  • 已有包含工具、账单对账等环节的 RapidAPI 集成。
  • 希望自选 OpenAI / Anthropic / Cohere / Mistral,市场端点允许你选择。

并行使用

没有什么能阻止你同时使用两个渠道。市场调用访问 api.qr-branding.com,消费者网站流程访问 qr-branding.com/api/internal/...。同一个引擎,两套计费,互不冲突。

如果拿不准是否该迁移,直接回复你最近一张收据即可,邮件会直接发给我们。