中转站新手指南：从注册到调用与查账

先理解：中转站不是聊天网页

中转站把多个 AI 模型通过统一入口提供给客户端或程序。一次调用至少需要 服务地址（Base URL）、本站令牌（API Key）、精确模型 ID 和 匹配的端点/协议。聊天产品会员、原厂密钥和本站令牌通常互不通用；只更换模型名，也不能让 OpenAI、Anthropic、Gemini 等不同协议的请求体自动兼容。

第一次使用建议按下面的顺序完成，每一步只验证一个问题：

Copy注册/登录 → 模型广场 → 充值/兑换 → 创建令牌
           ↓
在线测试或最小调用 → 使用/任务日志 → 按 Request-ID 求助

第一步：注册登录并保护账户

从注册或登录进入。邮箱验证、邀请码、第三方登录、Passkey 和两步验证是否出现，取决于当前站点配置；页面没有显示的方式不要默认可用。登录后可在个人设置维护安全信息。

为账户使用独立密码并开启当前站点提供的额外验证。令牌泄漏后应立即在令牌管理中停用或删除，再创建新令牌并替换客户端配置；不要只修改令牌名称，也不要在聊天、截图、工单或代码仓库中粘贴完整密钥。

第二步：先选模型，再决定充值

打开模型广场，先按自己的任务选择模型，再核对四项信息：精确模型 ID、支持端点、可用分组、当前价格/计费单位。厂商文档中的型号不等于本站一定开放；模型广场展示名、模型家族名也不一定能直接作为请求中的 model。

新手可以先选择成本较低、支持文本对话的模型完成连通测试。图片、视频、语音、重排和 Agent 可能使用不同端点、请求格式与计费单位，不要用文本聊天请求体直接尝试。模型详情若提供在线测试和示例代码，优先从那里复制当前模型、分组和端点对应的配置。

第三步：充值，并分清两层额度

在充值与钱包查看当前站点开放的充值、兑换码、套餐或其他入账方式；并非每个站点都会开放所有方式。支付后先查看充值记录和订单状态，待处理订单不要连续重复支付。充值前确认币种、实付金额、到账额度和适用范围。

账户余额是账户能够消费的总额度；令牌额度/次数是某枚 API Key 的额外使用上限，不会凭空增加账户余额。账户有余额但令牌额度耗尽，或令牌有额度但账户余额不足，调用都可能失败。订阅、等级、分组权益也可能限制可用模型，应以页面当前展示为准。

第四步：创建第一枚令牌

打开令牌管理创建令牌。对第一次调用，推荐只做最小配置：填写容易识别的名称，选择一个当前可用的主分组，设置合理的有效期和小额测试额度。先不要开启模型限制、IP 白名单、备用分组、跨组重试或复杂路由偏好；最小调用成功后再逐项收紧。

“分组”会影响可用模型、路由与价格，不是普通文件夹。若有多个分组，先使用模型广场为该模型显示的可用分组；备用分组和自动重试可能改变实际路由与费用。复制令牌后只存放在服务端环境变量或可信客户端的密钥设置中。

第五步：用最短路径完成第一次调用

推荐依次选择以下方式之一：模型详情中的在线测试、控制台操练场、或 AI API 快速入门中的最小 curl。前两种更适合确认站内配置，curl 更适合排除第三方客户端和 SDK 的影响。

可以先查询当前令牌可见的模型列表，再调用模型详情标注的端点：

Copyexport BASE_URL="https://你的服务地址"
export API_KEY="你的本站令牌"

curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $API_KEY"

/v1/models 成功只说明服务地址和令牌基本可用，不代表任意模型、端点或参数都已验证。随后复制模型广场中的精确 ID 做一次短文本请求；成功后再增加流式、图片、工具、长上下文等能力。

第六步：填写第三方客户端的四个字段

不同客户端叫法不同，但核心映射固定：

• Provider / API 类型：选择与目标端点匹配的 OpenAI、Anthropic、Gemini 等协议，不要只按模型品牌猜协议。
• Base URL / API Base：填写当前站点地址；是否带 /v1 取决于客户端，不能拼成 /v1/v1 或漏掉协议路径。
• API Key / Token：填写在本站创建的完整令牌，不要混用原厂密钥；同时确认令牌复制完整且仍处于启用状态。
• Model：填写模型广场的精确模型 ID，不要填写展示名、简称或模型家族名。

若客户端自动探测失败，先不要频繁更换所有选项。记录它实际请求的脱敏 URL、协议类型和错误正文，再用相同地址、令牌、模型和端点执行最小 curl 对比。

第七步：按 Request-ID 查结果和费用

同步文本调用主要到使用日志查看；图片、视频、音频等异步请求还要到任务日志或对应的绘图日志查看状态。异步接口返回任务 ID 或“已受理”只表示提交成功，不代表生成已经完成，也不要因等待而立即重复提交。

排查时优先保存并搜索 Request-ID、任务 ID、发生时间、模型、分组、请求路径、状态码和最终消费。账单应以最终消费日志为准：预扣可能在结算后增补或退回，重试也可能形成多笔真实调用。详细规则见计费、用量与成本核对。

高频问题速查

• 模型列表为空或模型不可用：检查令牌是否启用或过期、分组和模型限制，再到模型广场确认当前令牌可用的精确 ID 与端点。
• 401：检查 Authorization Header 和令牌是否完整有效；重新复制时避免多余空格或混用原厂 Key。
• 403 或额度不足：分别到钱包、令牌管理和日志核对账户余额、令牌额度/次数、分组与等级权限。
• 404 / model not found：核对 Base URL、/v1、精确模型 ID 和端点，再用模型详情示例与最小 curl 对比。
• 400：检查 JSON、协议、字段和上下文大小；删除可选参数，只保留最小请求。
• 429：阅读错误正文，区分余额/配额、频率与分组容量；余额类先处理账户，只有临时限流才做有限退避重试。
• 超时或 5xx：先看使用日志/任务日志是否已有记录，按 Request-ID 或任务 ID 查终态，避免重复提交和扣费。
• HTTP 200 但没有正文：检查流内错误、工具调用、安全拒绝和停止原因，保存完整脱敏事件后再看排错指南。

更完整的状态码和重试边界见 API 报错排查指南。不要对 400、401、403、余额不足或明确的参数错误无限重试。

提交工单前的安全清单

若仍无法解决，可在工单中提供：发生时间、模型精确 ID、分组、请求路径、HTTP 状态、Request-ID/任务 ID、客户端及版本、脱敏后的请求结构和错误正文。说明最小 curl 是否成功，能大幅缩小问题范围。

提交前删除完整令牌、密码、支付凭证、身份证明、图片 Base64、个人信息和业务机密。若怀疑令牌已经泄漏，应先停用和轮换，再提交工单；客服不需要完整密钥即可按 Request-ID 排查。