使用文档

3 分钟接入 API1314。

获取 API Key调用 API常见问题

第一步：获取 API Key

  1. 注册 → 控制台 → API Keys → 新建
  2. 立即复制完整 key（自己的KEY），关闭弹窗后无法再次查看
前往控制台获取 Key

第二步：调用 API

优先推荐使用 Codex，一条命令即可完成安装和 API1314 配置。

系统：

Codex 使用方法

一条命令行，完成全部安装和设置。终端输入对应系统的命令即可。

务必使用分配给自己的 API Key。

Mac
curl -fsSL https://codex-clyh.api1314.com/setup.sh | bash -s -- 自己的KEY
一键安装不可用时，查看手动配置
临时设置（仅当前终端窗口有效）
export OPENAI_API_KEY="自己的KEY"
export OPENAI_BASE_URL="https://api.api1314.com/v1"
永久设置（推荐，每次开终端自动生效）
echo 'export OPENAI_API_KEY="自己的KEY"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.api1314.com/v1"' >> ~/.zshrc
source ~/.zshrc

老版本 bash 用户把 ~/.zshrc 换成 ~/.bash_profile。

验证是否设置成功
echo $OPENAI_API_KEY
测试调用
codex -m gpt-5.6-sol
或者：用 curl 直接测试 key（不需要装 CLI）
curl https://api.api1314.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "messages": [{"role": "user", "content": "你好"}]}'

常见问题

返回 401 Unauthorized

检查复制的 key 前后有没有多余的空格或引号；确认 key 没有过期或被停用（控制台 → API Keys 里状态是否“已停用”）。

环境变量设置了，但调用还是提示没有 key

Windows 上 setx 设置后必须开一个新窗口才生效； Mac 上如果没执行 source ~/.zshrc，也需要重开一个新终端窗口。

Windows 提示找不到 curl 命令

curl.exe 从 Windows 10 1803 版本才开始自带，可以在 PowerShell 里运行 curl.exe --version 检查；没有就升级 Windows。

Cursor / Codex 连不上，提示网络错误

确认 Base URL 有没有漏加 /v1——OpenAI 兼容工具（Cursor、Codex、SDK）都需要带/v1；只有 Claude Code 的 ANTHROPIC_BASE_URL 不需要加。

余额扣得比预期快 / 想知道用了多少

登录后进入控制台 → 用量，可以看到每个 key 的实时消耗和额度。