Lumio API 帮助文档

3 min read 861 字

统一请求 URL：https://api.lumio.games/
在线 image2生图体验 ：img.lumio.games

社区支持：QQ群 1073671738 ｜ Telegram

Image-2 生图环境

支持模型

模型说明
gpt-image-2标准生图 1K
gpt-image-2-pro高质量生图 2K/4k

API 调用示例

curl --request POST 'https://api.lumio.games/v1/images/generations' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <your-api-key>' \
  --data '{
    "model": "gpt-image-2pro",
    "prompt": "换一套风格的衣服 换个主题色",
    "size": "2560x1440",
    "reference_images": [
        "https://img.lumio.games/your-image.png"
    ]
}'

Codex 环境

安装 Codex CLI

需要 Node.js 18+ 和 npm 8+。

# 安装
npm install -g @openai/codex

# 验证
codex --version

支持模型

模型说明
gpt-5.5需手动配置，价格倍率 0.2:1（约官方 0.03 倍）
gpt-5.4默认 256K 上下文，可开启 1M
gpt-5.3-codex-spark—
gpt-5.4-mini—

GPT-5.5 配置方法

Codex 默认不识别 gpt-5.5，会报错：

Model metadata for gpt-5.5 not found. Defaulting to fallback metadata; this can degrade performance and cause issues.

按以下步骤修复：

  1. 下载 GPT-5.5 配置文件，解压到对应目录：

  2. 在 CC Switch 中设置（或手动编辑 config）：

model = "gpt-5.5"
model_catalog_json = '帮助文档/model_catalog_gpt_5.5.json'
model_reasoning_effort = "high"
  1. 更新 Codex CLI 到最新版：
npm i -g @openai/codex@latest
  1. 启动 Codex，开始使用。

GPT-5.4 开启 1M 上下文

默认 256K 上下文。如需 1M 超长上下文，在 config 文件中添加：

model_context_window=1000000
model_auto_compact_token_limit=900000

Claude Code 环境

安装 Claude Code

Mac / Linux / WSL（推荐）：

curl -fsSL https://claude.ai/install.sh | bash

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

在 Claude Code 中使用 GPT 分组

Claude Code 支持直接切换到 GPT 模型。只需在创建 API 密钥时选择 GPT 分组，其余配置无需改动。

第一步： 在 CC Switch 中选择分组为 GPT
第二步： 点击导入即可使用

file-20260427143335268.jpg

第三步： 查看计费

file-20260427143318897.jpg

Gemini CLI 环境

支持模型

模型说明
gemini-3.1-pro-preview—
gemini-3-pro-preview—
gemini-3-flash-preview—

小龙虾等 Agent 环境

模型建议为 gpt-5.4
请求 URL 设置为：https://api.lumio.games/v1

Cursor 环境

  1. 下载插件：cursor-byok Releases
  2. 请求 URL 设置为：https://api.lumio.games/v1

OpenCode 环境

  1. 下载 OpenCode：OpenCode Releases
  2. 请求 URL 设置为：https://api.lumio.games/v1

CC Switch 安装与使用

CC Switch 是管理和切换 API 供应商的开源工具（作者：farion1231）。

Mac

  1. 在 Releases 页面下载 .dmg 文件
  2. 打开 dmg，将 CC Switch 拖入 Applications 文件夹

Windows

  1. 在 Releases 页面点击「Show all assets」展开完整列表
  2. 下载 Windows.msi 安装包
  3. 双击 msi，按提示完成安装

新手引导

  1. 点击 API 密钥
  2. 点击创建
  3. 创建分组——分组倍率代表折扣额度，推荐选择 GPT 分组 或 Claude/Kiro 分组
  4. 点击导入 CC Switch
  5. 当看到 CC Switch 查看余额成功，即可开始使用