MagicAPI
接入文档

快速开始

安全提醒：页面里所有 sk-你的Token 都是占位符。不要把真实 Token 发给别人，也不要写进公开 GitHub 仓库。

推荐模型

curl 测试

1）列模型

curl https://api.magicapi.cc/v1/models \
  -H "Authorization: Bearer sk-你的Token"

2）Chat Completions

curl https://api.magicapi.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "只回复 ok"}],
    "max_tokens": 20
  }'

3）Responses / Codex API

curl https://api.magicapi.cc/v1/responses \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "input": "只回复 ok"
  }'

OpenAI SDK 示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://api.magicapi.cc/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "只回复 ok"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Token",
  baseURL: "https://api.magicapi.cc/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "只回复 ok" }],
});
console.log(resp.choices[0].message.content);

Codex CLI 配置

Codex CLI 不建议只设置 OPENAI_BASE_URL。更稳定的方式是写入 ~/.codex/config.toml，指定 provider、Base URL 和 wire_api = "responses"。

model = "gpt-5.3-codex"
model_reasoning_effort = "high"
model_provider = "magicapi"

[model_providers.magicapi]
name = "MagicAPI"
base_url = "https://api.magicapi.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
supports_websockets = false
requires_openai_auth = true

然后设置环境变量：

# macOS / Linux
export OPENAI_API_KEY="sk-你的Token"

# Windows PowerShell
setx OPENAI_API_KEY "sk-你的Token"

测试：

mkdir codex-test
cd codex-test
git init
codex exec "只回复 ok"

Windows Codex 一键部署

在 Windows PowerShell 里执行下面命令。脚本会自动检查 Node/npm、安装 Codex CLI、提示你粘贴 MagicAPI Token，并写好 %USERPROFILE%\.codex\config.toml。

irm https://api.magicapi.cc/install-codex.ps1 -OutFile $env:TEMP\magicapi-codex.ps1; powershell -ExecutionPolicy Bypass -File $env:TEMP\magicapi-codex.ps1

脚本不包含任何真实密钥；Token 只在你的 Windows 当前用户环境里保存。

如果公司电脑禁用了脚本执行，可以先下载查看：

Invoke-WebRequest https://api.magicapi.cc/install-codex.ps1 -OutFile .\magicapi-codex.ps1
notepad .\magicapi-codex.ps1
powershell -ExecutionPolicy Bypass -File .\magicapi-codex.ps1

VS Code / OpenAI Compatible 应用

任何支持 OpenAI Compatible / Custom OpenAI 的应用，一般这样填：

如果应用支持 Responses API / Codex 模式，代码模型优先选 gpt-5.3-codex。

故障排查

• 401 / Invalid token：Token 错了、复制多了空格，或没有在控制台创建 API Token。
• 模型不存在：模型名要完整填写，例如 gpt-5.5、gpt-5.3-codex。
• 余额/额度不足：去控制台查看额度和调用日志。
• Codex 不走 MagicAPI：检查 ~/.codex/config.toml 是否有 model_provider = "magicapi" 和 wire_api = "responses"。
• Windows 设置后无效：关闭并重新打开 PowerShell / VS Code；必要时结束所有 Code.exe 再打开。
• 网络或服务异常：先看 status.magicapi.cc，再看控制台调用日志。

常用入口

• API Keys：创建和管理调用密钥。
• 控制台：查看概览、额度和用量。
• 调用日志：排查请求失败和消耗记录。
• 模型广场：查看模型、额度与套餐信息。
• 服务状态页：查看服务可用性。