很多人卡在第一步:注册完不知道密钥在哪、接口地址填什么、报错不知道是自己配错了还是站点有问题。这篇按「注册—选模型—充值—拿 Key—填配置—跑通第一次调用」的顺序走一遍,每一步给你判断依据和排查方向。价格、倍率、可用模型这类会变的数字,都去站内对应页面看当时的值,别照抄别人截图。
很多人卡在第一步:注册完不知道密钥在哪、接口地址填什么、报错分不清是自己配错了还是站点有问题。这篇不讲原理,只按「注册—选模型—充值—拿 Key—填配置—跑通第一次调用」的顺序走一遍,每一步给你判断依据和排查方向。
先记住一个前提:价格、倍率、可用模型这类会变的数字,都到站内对应页面看当时的值,别照抄别人的截图或旧教程。下面所有涉及数字的判断,都只给你「去哪看」,不给你「是多少」。
注册、实名与拿到第一把 Key
- 注册时留真实可收信的邮箱,很多站点的重置密码和额度告警只走邮件;顺手确认是否要手机号或实名,这决定你后面能不能自己充值。
- 登录后在控制台找「API Key / 令牌」入口,新建时给个能认出来的名字(比如按项目命名),并设一个额度上限;一人一把 Key,别几台机器共用。
- Key 通常只在创建时完整显示一次,复制后存进密码管理器;别贴进聊天窗口、别提交进 Git 仓库,公共仓库扫 Key 是分钟级的事。
- 看清单价和计费口径(按 token 还是按次、有没有倍率),再到 /ai-nav/category/ai-api 对照同类平台的费率区间,判断这把 Key 值不值得往下用。
先挑一个便宜的模型把链路跑通
第一次别直接上贵的旗舰模型。你要验证的是「网络通、Key 有效、余额够」这三件事,不是验证模型效果。所以挑一个便宜、限速宽松的小模型,跑通之后再换正式要用的那个。
- 查标准模型名到 /models 里查该模型的标准名称。中转站常给模型起别名或以分组形式暴露,名字对不上就会报「模型不存在」,这一步别凭记忆写。
- 确认调用方式想清楚你是接聊天网页、代码编辑器,还是自己写脚本,三种方式填的字段不一样,先定下来再动手。
- 补基础术语拿不准 temperature、max tokens、上下文长度这些参数含义,先翻 /ai-dict/category/basics,比在群里问快,也不会被人带偏。
接口地址、Key 怎么填,第一次调用怎么验
中转站通常给你一个 Base URL 加一段路径,规则是「平台给的基础地址 + 各家 SDK 约定的后缀」。填错最常见的结果是 404 或路径重复,所以别急着上正式任务,先做一次最小请求。
| 你要填的项 | 常见填法 | 容易踩的坑 |
|---|---|---|
| Base URL | 平台给的地址,按说明补或不补后缀 | 把后缀重复拼一次,路径变成两段 |
| API Key | 创建时复制的那一串 | 前后带空格、少复制几位 |
| 模型名 | 服务端模型列表里的写法 | 自己写成常见叫法,报模型不存在 |
| 输出上限 | 先调到最小 | 开太大,一次请求就把额度吃掉块 |
填完先发一句话提示词,能拿到回复就说明链路通了。接着到 /tools/speed-test 量一次延迟,把结果记下来当作你自己的基线,以后变慢能对照。换客户端只改 Base URL 和 Key 两处,模型名保持服务端写法,改完一定重跑一次最小请求。想顺带看看站点给的是不是真模型,用 /tools/verify 跑一遍对照,比自己猜靠谱。
常见报错怎么定位,日常怎么用不踩线
报错先按状态码分方向,别一上来就怀疑站点跑路。下面这张对照表按「先查什么」排序,照顺序走能省很多时间。
| 现象 | 先查什么 | 判断依据 |
|---|---|---|
| 401 / 403 | Key 是否复制全、是否被禁用 | 换回最小请求,仍报错就新建一把 Key 试 |
| 404 | 路径拼接是否重复或缺失 | 对着站点文档核对 Base URL 写法 |
| 429 | 限速与并发是否超了 | 降并发、放慢节奏再试,仍不行看站点公告 |
| 余额类提示 | 账户余额与分组权限 | 到控制台看余额页,确认这个模型在不在你的分组里 |
- 报错连续出现两次以上,先换回最小请求复现,再截图保存请求时间和返回内容,后面找客服或换站都用得上。
- 控制台给每把 Key 设限额,把余额告警打开;这两件事花两分钟,能避免半夜被刷爆。
- 每隔一段时间到 /price-watch 看一次价格变动,别按旧印象续费。
- 把「先用便宜模型验证、再切正式模型」当成固定动作,换电脑、换网络、换客户端都重跑一遍。
报错先分方向再动手:Key 的问题、路径的问题、额度的问题,是三条不同的排查线,混在一起查只会越查越乱。下一步挑站点的过程里,可信度和价格是两回事,先看清楚再决定用哪家。→
常见问题
中转站的 API 地址和 Key 到底填在哪?
一般填在客户端或代码里的两处配置:Base URL(接口地址)和 API Key。Base URL 用平台给的基础地址,后面按所用 SDK 的约定拼路径;Key 在控制台新建后复制。填完先跑一次最小请求验证,报错再按状态码排查,别一次性改多处。
为什么我注册充值了还是调不通?
先排除三件事:Key 是否复制完整且未被禁用、余额是否到账、模型名是否和服务端列表一致。这三项都对还失败,就用最小请求复现并记录返回内容,再去找站点客服。中途换过客户端或网络的,把配置重置成官方示例再试一次。
新手第一次该充多少、用哪个模型试?
建议先用最小金额试水,只验证链路,别一次压大额。模型选便宜、限速宽松的一档,跑通后再切正式模型。具体充多少合适、额度和风险怎么配比,到 和站内的首充预算类文章对照着定,别照搬别人的数字。