API DOCS

文档

使用同一个 Ununu 账号生成 unu- key 后接入 Codex、Claude Code 或常用 API。

查看模型

Codex /v1 Base URLhttps://api.ununu.ai/v1

快速开始

先拿到自己的 unu- key，再选择 Codex 或 Claude Code 接入。

01登录

进入 Gate 控制台，使用统一 Ununu 账号登录。

02创建 Key

在控制台创建自己的 unu- key，不要共享主账号。

03选择入口

Codex 使用 /v1 Base URL；Claude Code 使用不带 /v1 的 Base URL。

04开始使用

按下面命令复制配置；用量和账单在控制台查看。

支持入口

当前公开入口展示 Codex、Claude Code、GPT Responses API 和图片 API。

/v1/messages

在 Claude Code 中设置 ANTHROPIC_BASE_URL，客户端会自己请求 /v1/messages。

/v1/responses

GPT 文本请求可以直接使用 OpenAI Responses 结构调用。

/v1/images/generations

根据文本 prompt 生成图片，返回 base64 图片数据。

/v1/images/edits

基于已有图片和 prompt 生成编辑后的图片。

复制配置与 API 调用

把 unu-... 换成自己的 Key；Codex 桌面只需要手动编辑 ~/.codex/config.toml。

Codex macOS 桌面默认配置

vi ~/.codex/config.toml

model_provider = "openai"
model = "gpt-5.5"
openai_base_url = "https://api.ununu.ai/v1"

# 打开 Codex 后选择 API key 登录，粘贴你的 unu-... key。
open -a Codex || codex

Codex Windows 桌面默认配置

notepad %USERPROFILE%\.codex\config.toml

model_provider = "openai"
model = "gpt-5.5"
openai_base_url = "https://api.ununu.ai/v1"

# 打开 Codex 后选择 API key 登录，粘贴你的 unu-... key。
codex

Codex 单次执行

CODEX_API_KEY="unu-..." codex exec \
  -c 'model_provider="openai"' \
  -c 'openai_base_url="https://api.ununu.ai/v1"' \
  --model gpt-5.5 \
  "只回答 pong"

Responses API curl

curl -X POST "https://api.ununu.ai/v1/responses" \
  -H "Authorization: Bearer unu-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.5",
    "input": "只回答 pong"
  }'

Responses API Node.js

const response = await fetch("https://api.ununu.ai/v1/responses", {
  method: "POST",
  headers: {
    Authorization: "Bearer unu-...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "openai/gpt-5.5",
    input: "只回答 pong"
  })
});

console.log(await response.json());

图片生成 API curl

curl -X POST "https://api.ununu.ai/v1/images/generations" \
  -H "Authorization: Bearer unu-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "为 Ununu Gate 生成一张极简产品海报，白底、黑色主视觉、科技感",
    "size": "1024x1024",
    "quality": "medium",
    "n": 1,
    "response_format": "b64_json"
  }'

图片生成 API Node.js

const response = await fetch("https://api.ununu.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer unu-...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "openai/gpt-image-2",
    prompt: "为 Ununu Gate 生成一张极简产品海报，白底、黑色主视觉、科技感",
    size: "1024x1024",
    quality: "medium",
    n: 1,
    response_format: "b64_json"
  })
});

const result = await response.json();
const imageBase64 = result.data?.[0]?.b64_json;

图片编辑 API curl

curl -X POST "https://api.ununu.ai/v1/images/edits" \
  -H "Authorization: Bearer unu-..." \
  -F "model=openai/gpt-image-2" \
  -F "prompt=保留主体，把背景改成干净的白色产品摄影棚" \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -F "response_format=b64_json" \
  -F "image=@./source.png"

图片编辑 API JSON

curl -X POST "https://api.ununu.ai/v1/images/edits" \
  -H "Authorization: Bearer unu-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "保留主体，把背景改成干净的白色产品摄影棚",
    "image": { "url": "https://example.com/source.png" },
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "b64_json"
  }'

Codex 内切换模型

open -a Codex || codex

# 进入 Codex 后输入 /model，然后选择或输入：
gpt-5.5
openai/gpt-5.4
openai/gpt-5.4-mini
openai/gpt-5.3-codex-spark

Codex 图片 Skill

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/ununuAI/ununu-skill-codex-image.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/ununu-skill-codex-image"

# 先按上面的 Codex 桌面配置写好 ~/.codex/config.toml
# 然后在 Codex 里说：
使用 $ununu-skill-codex-image 生成一张白底黑字 UNUNU 的测试图。

Claude Code

export ANTHROPIC_BASE_URL="https://api.ununu.ai"
export ANTHROPIC_AUTH_TOKEN="unu-..."
export ANTHROPIC_MODEL="openai/gpt-5.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="openai/gpt-5.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="openai/gpt-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="openai/gpt-5.4-mini"
claude

调用规则

Codex 使用内置 openai provider；config.toml 只改 openai_base_url。
macOS 和 Windows 都手动编辑 Codex config.toml，只需要填 model_provider、model 和 openai_base_url；不要把 key 写进配置文件。
打开 Codex 后选择 API key 登录，粘贴你的 unu-... key；如果之前登录过官方 OpenAI key，先退出再登录 unu-key。
一个 config.toml 只能有一个默认 model；用户进入 Codex 后用 /model 切换模型，--model 只适合启动新线程时临时覆盖。
Codex 需要生图或改图时，安装 https://github.com/ununuAI/ununu-skill-codex-image；它会复用 Codex 登录保存的 unu-key。
Claude Code 的 ANTHROPIC_BASE_URL 不要加 /v1；模型环境变量使用 Gate 公开模型名。
GPT 文本请求可以直接调用 /v1/responses；图片生成和图片编辑使用 /v1/images/generations、/v1/images/edits。
除上面列出的常用 API 外，其它直接 API 调用方式先不展示。
余额、请求记录和用量在控制台查看。
如果接口返回 request_id，排障时直接复制 request_id。

常见错误

401

key 缺失或无效。

403

key 被禁用、模型不可用、额度不足或策略不允许。

429

当前容量不足或并发达到限制，稍后重试。

5xx

平台或上游异常，保留 request_id 便于排查。