获取 API Key 与鉴权
在开始调用 API 之前，请先了解如何获取并管理您的专属密钥。
1. AI 大模型 API Key (用于调用 LLM、绘画、视频模型)
该密钥用于访问我们在“模型广场”中提供的所有生成式 AI 模型。
1.1 获取与创建令牌 (Token)
- 1.登录控制台，在左侧导航栏找到并点击 API key （位于“使用日志”下方）。
- 2.为了更好的安全控制，建议点击页面顶部的“+添加令牌”，为不同项目生成独立密钥。
1.2 核心配置：分组类型与令牌分组
新建令牌需选择分组类型，系统支持三种智能路由策略：
- 价格优先：动态调度至当前最高性价比的底层通道。
- 稳定优先：动态调度至当前最高可用性（高 SLA）的通道。
- 指定分组：手动精细化配置底层通道（操作流程：选择“模型提供商” -> 选择“令牌分组”）。
在“指定分组”下，分组名称通常由 前缀（模型品牌或通道来源） + 后缀（SLA 属性） 构成： 常见前缀示例（代表模型品牌或云通道）：
- 文本与核心大模型
- gpt / openai: OpenAI 系列
- claude / cl / aws: Anthropic Claude 系列及底层云厂商通道
- gemini / gm: Google Gemini 系列
- deepseek / ds: DeepSeek 深度求索
核心后缀说明（代表底层 SLA 与并发属性）：
- -of (Official / 原厂通道)：100% 官方原生或头部云厂商直连。SLA 极高，企业级生产环境首选。
- -vip (VIP Pool / 高可用池)：优质大并发池或专属独立节点。保障高并发下的高稳定性。
- -sp (Special Pool / 特惠池)：标准特惠资源池。极高性价比，开发测试与日常代码调试首选。
- -s (Saver / 抢占式特价池)：极致特价资源（不保障稳定性），适用于对成本极度敏感的任务。
- -sl / -fa (Slow & Fast)：慢速 / 快速通道。专用于 Midjourney 等图像生成任务的速率分级。
- -pro / -cli / -re：针对特定账户体系或特定场景的专属混合资源池。
⚠️ 重要提示： 由于系统会根据当前账户的权限等级和业务场景动态下发可用资源，不同账户看到的分组名称长度与具体前缀可能存在细微差异（例如 Claude 可能显示为
claude-aws-of或简写为cl-of）。 请一律以您当前控制台下拉列表中实际展示的分组名称为准。 如有企业级大并发与私有化部署定制需求，请联系专属商务对接。
2. 密钥安全与高级配置
在“新建令牌”时，APIShop 提供了一系列企业级风控配置，强烈建议您在投入生产前完成设置：
- 额度设置 (Quota Limit)：默认情况下令牌无额度限制（受限于账户总余额）。您可以为下发给团队成员或特定工具的 Token 设置固定美金总额，超出该额度 Token 即失效，有效防止代码死循环造成的资金损失。
- 过期时间 (Expiration)：可一键设置为“一个月”、“一天”或自定义具体时间，适合为短期外包项目或临时测试分配密钥。
- 访问限制 (IP Whitelist)：支持绑定指定的服务器 IP 地址。即使密钥意外泄露，非白名单内的 IP 也无法发起调用，从根本上杜绝恶意盗刷。