基本概念

先弄清三个词：余额、密钥、分组。后面的配置都围绕它们。

余额

你在 Portdan 充的钱1 元 = 1 刀

密钥（Key）

客户端通过它使用 Portdan 的额度创建时选好分组

分组

一组模型的额度池便宜的、稳定的，每个分组下方都写着自己的介绍

你在 Portdan 充值余额，随后创建密钥、选择分组，通过密钥使用该分组下的额度池。

创建密钥时选模型厂商和分组；分组下方写着每个组的介绍和额度来源。

有额度就能用只要你有额度，你可以使用任何分组的任何模型。只要是你能看到的分组，都是可以使用的。

模型和客户端

所有模型都可以在任何客户端使用。当然，原生客户端配上原生的模型肯定最合适——GPT 配 Codex，Claude 配 Claude 客户端。

你的 Key 选择了什么分组，就代表你的这个 Key 里有哪些模型。

查看 Key 的全部模型

获取分组模型列表名称的指令：

curl https://portdan.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

把 sk-your-api-key 换成你的完整 Key，在终端命令行输入，即可查看到你当前选择的 Key 的全部模型名称。配客户端要填模型名时，从返回的列表里复制，一字不差。

额度在哪看，报错先想什么

余额和每一笔消耗都在 Portdan 后台实时显示，打开使用记录就能看到。

遇到报错，先想两件事：

1. 额度够不够。 额度不足时请求会直接报错，先去后台看一眼余额。
2. 网络通不通。 连不上大多是自己网络的问题，最常见的就是代理设置：节点不稳、没开 TUN／虚拟网卡，请求都发不出去。

两件都排除了还报错，再按问题排查清单一项项查。

看完这三个概念，开始接 Codex：Codex 接入教程。