从注册到第一次调用，只需四步。

注册、登录与安全

1. 打开 控制台登录页。首次使用请按页面提示注册。
2. 登录后会进入控制台。普通用户常用入口为「仪表盘」「API 密钥」「用量」「个人资料」。
3. 在「个人资料」中修改登录密码，并在可用时启用双重验证。

充值与订阅

按控制台提供的方式完成充值，或在「我的订阅 / 购买订阅」中选择可用套餐。支付完成后先返回仪表盘确认余额、订阅状态或订单状态已更新，再开始调用。

• 余额：通常按实际用量扣除；不同模型和分组可能采用不同价格倍率。
• 订阅：查看有效期、包含范围和剩余额度；到期或额度耗尽后请续订或切换可用分组。
• 兑换码：如运营方提供兑换码，可在「兑换」页面输入后刷新余额。

创建并保管 API 密钥

1. 在控制台左侧进入「API 密钥」。
2. 点击「创建 API 密钥」，填写一个方便识别的名称，例如 my-laptop。
3. 选择有权限的模型分组。列表中未分配的分组无法调用。
4. 按需设置额度、速率限制或 IP 白名单，然后保存。
5. 复制密钥并保存在密码管理器或安全的环境变量中。

查看模型与分组

密钥可调用的模型取决于它所属的分组。创建密钥后，在「可用渠道」或密钥页面查看可用模型和 API 地址。调用时必须使用控制台显示的模型标识符，不要自行猜测名称。

使用 OpenAI 兼容接口

基础地址是 https://api.littletangerine.site/v1。将其中的 YOUR_API_KEY 和 MODEL_ID 替换为控制台中的实际值。

curl https://api.littletangerine.site/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍自己。"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.littletangerine.site/v1",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.littletangerine.site/v1",
  apiKey: process.env.LT_API_KEY,
});

const result = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "你好" }],
});
console.log(result.choices[0].message.content);

客户端配置

多数支持 OpenAI 兼容接口的工具只需要两个值：Base URL 与 API Key。Base URL 填 https://api.littletangerine.site/v1，模型从控制台的可用模型列表选择。

查看用量、余额与请求记录

在「用量」页面可按时间、密钥、模型和分组筛选请求记录。它适合确认某次调用是否成功、消耗了多少、是否命中限流以及错误代码。

• 调用前后查看仪表盘余额，避免余额不足造成中断。
• 用不同密钥区分测试、个人项目和生产应用，账单会更容易核对。
• 导出记录前先设定时间范围，避免把无关数据混在一起。

同步与修复本地 Codex 记录

当更换 Codex 账号、API Key、认证方式或 Provider 后，左侧历史记录可能消失或只显示一部分。Codex History Sync 用于同步和修复当前电脑上的 Codex Desktop 本地历史数据。

从 Releases 下载

1. 打开 最新 Release 页面，不要从源码安装。
2. Windows x64 选择 Setup 安装包，或选择 Portable 免安装版；Windows on ARM 请选择 arm64 包。
3. macOS 下载与芯片架构相符的 DMG；Linux 选择对应架构的 AppImage 或 deb 包。
4. 安装或解压后启动 Codex History Sync。

推荐操作顺序

1. 完全退出 Codex Desktop，避免运行中的程序占用或覆盖本地数据库。
2. 在工具的「概览」页确认当前 Provider、模型、待同步记录数和可恢复备份。
3. 只有 Provider 不一致或记录待同步时，进入「历史同步」执行同步。
4. 若记录缺失、标题为空或同步结果异常，先运行「诊断数据库」，再选择「修复数据库」。
5. 同步、修复或恢复失败并提示权限不足时，使用工具提供的管理员权限重试。
6. 完成后重启 Codex Desktop，检查左侧历史是否恢复。

常见错误与处理方法

需要帮助时，请准备这些信息

联系管理员前，请准备发生时间、请求使用的模型、HTTP 状态码、错误消息和脱敏后的请求 ID。不要发送完整 API 密钥或登录密码。