Sub2API

接入 Codex

S3 · OpenAI 协议兼容 · 只改 Base URL 与 API Key

接入只改两个东西:Base URL 和 API Key。请求体、SDK、返回结构都不用动。

1. 注册并登录

注册后系统会发放一笔初始额度,可以直接调用;用完了在控制台「余额」页充值。

2. 创建 API Key

在控制台的「API Keys」新建。明文只在创建完成的那一次弹窗里出现,关掉就找不回来了 —— 列表里只有 sk- 开头的前 8 位前缀。丢了只能吊销重建。

3. 把 Base URL 指过来

下面四种方式任选一种,改完立刻生效。

Base URL
from openai import OpenAI

client = OpenAI(
    base_url="https://aiapigpt.com/v1",
    api_key="sk-your-sub2api-key",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
export OPENAI_BASE_URL=https://aiapigpt.com/v1
export OPENAI_API_KEY=sk-your-sub2api-key

codex "refactor this file"
# 任何允许自定义 OpenAI 兼容 Base URL 的客户端都能用(Cherry Studio、NextChat、各类 IDE 插件等)。
#
#   接口类型:OpenAI / OpenAI 兼容
#   Base URL:https://aiapigpt.com/v1
#   API Key :sk-your-sub2api-key
#   模型名  :填「实时价格」页里列出的名字
curl https://aiapigpt.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-sub2api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'

Python 与 Node SDK 同构,把 base_url 与 api_key 换掉即可。

四个最常见的坑

  1. 模型名必须填本站登记过的:以「实时价格」页列出的为准。没登记的模型不会自动转发,会直接返回没有可用上游账号。
  2. Base URL 末尾的 /v1 不能少,也不能多一层 —— 网关只认 POST /v1/chat/completions,其它路径一律 404。
  3. API Key 明文只在创建时出现一次。列表页看到的 sk-xxxx 前缀只是用来辨认的,拿它去调用会被判为无效 Key。
  4. 本站目前只实现 OpenAI 的 chat completions 协议。Claude Code 用的是 Anthropic 协议,直接指过来会 404;要用支持自定义 OpenAI Base URL 的客户端。

下一步:看 API 文档 →