接入教程 · Codex CLI

Codex CLI 接 HardysAPI
OpenAI 兼容端点即可

Codex CLI 走 OpenAI 兼容协议。把 Base URL 指到 HardysAPI,填入 sk- 密钥, 即可用充值余额在国内调用,无需海外信用卡。

先跑通再充值。调用不成功不扣费;1 元 = 1 美元额度;余额永久。

配置步骤

  1. 注册并创建 API Key
    控制台 → API Keys → 新建。Codex / Agent 场景建议选「日常主力」分组。
  2. 设置环境变量(OpenAI 兼容)
    不同 Codex 发行版环境变量名可能略有差异,优先用你所用 CLI 文档中的 Base URL / API Key 项;通用写法:
bash OpenAI 兼容
export OPENAI_BASE_URL="https://hardysapi.com/v1"
export OPENAI_API_KEY="sk-你的key"

# 部分工具也读:
export CODEX_BASE_URL="https://hardysapi.com/v1"
export CODEX_API_KEY="sk-你的key"
Base URL 必须以 /v1 结尾。若 CLI 要求完整 provider 配置文件,把 endpoint 写成 https://hardysapi.com/v1,模型名用控制台列表中的 id。
  1. 验证连通
    先用 curl 确认 Key 与 endpoint 正常,再进 CLI。
curl bash
curl -s https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

模型与价格怎么选

  • 日常 Agent / 编码:默认「日常主力」0.42x – 1.10x。
  • 批量脚本:经济档 0.01x – 0.32x,注意质量。
  • 生产 / 企业:满血档 + 发票,见开票说明。

常见问题

401 Unauthorized

Key 是否完整?是否误把 Authorization 写成了 x-api-key(那是 Anthropic 风格)?OpenAI 协议用 Bearer。

model not found

以控制台 / 模型广场的 model id 为准,不要凭记忆写版本号。

超时 / 限流

换分组或降低并发;仍异常提交工单附时间与 request id。