从 RapidAPI 迁移
如果你一直通过 RapidAPI 调用 Signet QR API,一切照常运行。市场渠道与以前完全相同:相同的 URL、相同的认证请求头、相同的 JSON 结构、相同的 SLA。
变化在于,同一个引擎现在还为 qr-branding.com 上的消费者网站提供支持,并提供一次性购买的额度包。你可以继续留在市场、切换过来,或者两者都用。
保持不变的内容
- URL:
api.qr-branding.com(CNAME 指向同一个 Azure Function Appsignetqr-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/...。同一个引擎,两套计费,互不冲突。
如果拿不准是否该迁移,直接回复你最近一张收据即可,邮件会直接发给我们。