本页已补充网站注册、充值、兑换码和使用流程。示例中的 sk-your-key 为占位符，请使用自己的令牌替换。

最近更新: 2026-05-03 14:54

8848AI API中转站使用教程与接入文档

更新时间：2026-05-03

本文档适用于 8848AI / 8848AI 中转站用户，用来接入 GPT、Claude、Gemini 3.1、图片生成等模型。示例中的 sk-your-key 是占位符，请替换为自己在控制台创建的令牌。

1. 快速接入信息

官网/控制台：

https://api.884819.xyz/

OpenAI 兼容接口地址：

https://api.884819.xyz/v1

Claude / Anthropic 兼容接口地址：

https://api.884819.xyz

常用请求头：

Authorization: Bearer sk-your-key
Content-Type: application/json

Anthropic / Claude Messages 接口也可使用：

x-api-key: sk-your-key
anthropic-version: 2023-06-01
Content-Type: application/json

接入前 30 秒检查

客户端类型优先选 OpenAI Compatible / OpenAI API / 自定义 OpenAI 地址。
GPT、Gemini、图片生成统一使用 https://api.884819.xyz/v1。
Claude Code 或 Anthropic Messages 原生模式使用 https://api.884819.xyz，不要在末尾加 /v1。
模型 ID 必须完整复制，例如 claude-opus-4.8、gpt-5.5、gpt-5.3-codex-spark、gemini-3.5-flash。
第一次测试先关闭流式输出，设置 stream: false，确认 PONG 成功后再跑长任务。
排查时不要发送完整 Key，截图里只保留前后 4 位。

2. 创建令牌

登录 https://api.884819.xyz/。
进入控制台的令牌/API Key 管理页面。
新建令牌，按用途选择对应分组。
复制生成的 sk-... 令牌，放入客户端、代码或环境变量。
先用 /v1/models 或简单聊天请求测试，再接入正式业务。

不要把真实令牌写进网页前端、公开仓库、截图、微信群或教程文档。令牌泄露后应立即删除并重新生成。

3. 网站注册、兑换与使用教程

本节根据飞书原教程补充，适合新用户第一次使用网站。

3.1 注册登录

打开官网：https://api.884819.xyz
点击注册，按页面提示创建账号。
注册完成后登录控制台。
登录后可自行创建密钥、查看额度、查看使用量。

3.2 兑换码使用

如果购买后拿到兑换码，按下面流程兑换：

打开官网：https://api.884819.xyz
注册并登录账号。
进入控制台的充值/兑换页面：https://api.884819.xyz/console/topup
输入兑换码并确认兑换。
兑换成功后，进入令牌/API Key 页面，自行创建令牌并配置额度。

兑换码示例格式：

bf84fbf95a734a2fbd259a4bef04637e

上面只是格式示例，不是可用兑换码。实际兑换码以下单后收到的为准。

3.3 在线充值

如果需要自行充值，按下面流程操作：

登录官网：https://api.884819.xyz
进入控制台的充值页面：https://api.884819.xyz/console/topup
选择充值金额和支付方式。
完成付款后回到控制台查看余额。
如果支付成功但余额未到账，请保留订单号或支付截图，联系客服核查。

充值到账后再创建令牌并调用模型。这样可以避免令牌已创建但余额不足导致调用失败。

3.4 使用顺序

新用户建议按这个顺序操作：

注册账号 -> 登录控制台 -> 充值或兑换额度 -> 创建令牌 -> 选择模型 -> 接入客户端或代码 -> 查看用量

常见页面用途：

页面	用途
首页	查看站点介绍和可用模型
控制台	查看账号、余额、用量、令牌
模型广场	查看当前支持的模型
令牌/API Key	创建 `sk-` 开头的调用密钥，地址：`https://api.884819.xyz/console/token`
兑换/充值	给账号增加额度，地址：`https://api.884819.xyz/console/topup`
日志/用量	检查模型调用记录和消耗

如果不会配置软件，优先把下面三项发给客服排查：

使用的软件名称
填写的 Base URL
选择的模型名称

不要发送完整 API Key。需要截图时，请遮住 sk- 令牌中间部分。

4. 分组选择

调用失败最常见的原因不是模型坏了，而是令牌分组和模型不匹配。

8848AI 目前统一使用 default 分组，所有模型均可通过 default 分组调用。

GPT / OpenAI 兼容分组：

default

Gemini 3.1 分组：

default

Claude 分组：

default

建议创建令牌时统一选择 default 分组。排查余额、权限和模型不可用问题时，也优先确认令牌是否属于 default 分组。

5. 推荐模型列表

以下为 8848AI 当前实际支持的全部模型，按模型家族分类。Claude 为平台首推模型。

Claude（首推）

claude-opus-4.8
claude-opus-4.8-thinking
claude-opus-4.8-max
claude-opus-4.7
claude-opus-4.7-thinking
claude-opus-4.7-max
claude-opus-4.6
claude-opus-4.6-thinking
claude-opus-4.6-max
claude-sonnet-4.6
claude-sonnet-4.6-thinking
claude-sonnet-4.6-max
claude-haiku-4.5
claude-haiku-4.5-thinking

推荐选择：

场景	推荐模型
Claude Code、复杂编程、长任务	`claude-opus-4.8` / `claude-opus-4.7`
极高质量 + 深度思考	`claude-opus-4.8-thinking` / `claude-opus-4.7-thinking`
最高输出质量（不限成本）	`claude-opus-4.8-max` / `claude-opus-4.7-max`
日常写作、翻译、问答	`claude-sonnet-4.6`
轻量、低成本	`claude-haiku-4.5`

Grok

grok-4.20-fast
grok-4.20-thinking
grok-4.20-image

推荐选择：

场景	推荐模型
快速问答、日常对话	`grok-4.20-fast`
深度推理、复杂分析	`grok-4.20-thinking`
图片理解、多模态	`grok-4.20-image`

GPT 文本/代码模型

gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex-spark
gpt-4.1
gpt-4.1-mini

推荐选择：

场景	推荐模型
综合能力、长文本、复杂任务	`gpt-5.5`
高质量通用问答	`gpt-5.4`
低成本、速度优先	`gpt-5.4-mini`
编程、代码审查、仓库分析	`gpt-5.3-codex-spark`
稳定备用	`gpt-4.1` / `gpt-4.1-mini`

GPT 图片生成

gpt-image-2

接口：

POST /v1/images/generations

Gemini

gemini-3.5-flash
gemini-3.5-flash-low
gemini-3.5-flash-thinking
gemini-3.5-flash-thinking-lite
gemini-3.1-pro
gemini-3.1-pro-high
gemini-3.1-pro-low
gemini-3.1-flash-image
gemini-3-flash
gemini-3-flash-agent
gemini-pro-agent
gemini-flash-lite

推荐选择：

场景	推荐模型
Gemini 最新主力	`gemini-3.5-flash`
深度推理思考	`gemini-3.5-flash-thinking`
高质量推理	`gemini-3.1-pro-high`
常规调用	`gemini-3.1-pro-low` / `gemini-3-flash`
图片生成/理解	`gemini-3.1-flash-image`
低成本快速	`gemini-3.5-flash-low` / `gemini-flash-lite`
Agent / 工具调用	`gemini-3-flash-agent` / `gemini-pro-agent`

实际可调用列表以令牌请求 /v1/models 返回结果为准。

6. 检查令牌可用模型

curl https://api.884819.xyz/v1/models \
  -H "Authorization: Bearer sk-your-key"

如果返回列表中没有目标模型，通常是令牌分组不对、模型未授权、余额不足或该模型暂未开放给该令牌。

7. OpenAI 兼容聊天接口

绝大多数客户端选择 OpenAI Compatible、OpenAI API、自定义 OpenAI 地址 时，都填下面这组信息：

Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: gpt-5.5

cURL

curl https://api.884819.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "请回复 PONG"}
    ],
    "stream": false
  }'

Python

安装：

pip install openai

调用：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://api.884819.xyz/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "请回复 PONG"},
    ],
)

print(response.choices[0].message.content)

Node.js

安装：

npm install openai

调用：

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "sk-your-key",
  baseURL: "https://api.884819.xyz/v1",
});

const response = await openai.chat.completions.create({
  model: "gpt-5.5",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "请回复 PONG" },
  ],
});

console.log(response.choices[0].message.content);

流式输出

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "sk-your-key",
  baseURL: "https://api.884819.xyz/v1",
});

const stream = await openai.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "写一段 100 字产品介绍" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices?.[0]?.delta?.content || "");
}

Codex CLI 接入 8848AI

Codex 适合代码生成、仓库分析、自动修复 Bug、代码审查等开发场景。8848AI 以 OpenAI 兼容接口接入 Codex 时，推荐使用 gpt-5.3-codex-spark；如果该模型暂时不可用，可切换到 gpt-5.5、gpt-5.4 或 gpt-4.1。

准备信息：

Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: gpt-5.3-codex-spark
令牌分组: default

安装 Codex CLI：

npm install -g @openai/codex

macOS 也可以使用 Homebrew：

brew install codex

设置本机环境变量。Windows PowerShell 临时设置：

$env:OPENAI_API_KEY="sk-your-key"

Windows PowerShell 长期保存到当前用户：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-key", "User")

macOS / Linux：

export OPENAI_API_KEY="sk-your-key"

创建或编辑 Codex 配置文件：

Windows: %USERPROFILE%\.codex\config.toml
macOS/Linux: ~/.codex/config.toml

推荐配置一：直接覆盖内置 OpenAI 地址。

model = "gpt-5.3-codex-spark"
openai_base_url = "https://api.884819.xyz/v1"

推荐配置二：单独创建 8848AI Provider，便于以后和官方 OpenAI 或其他中转站切换。

model = "gpt-5.3-codex-spark"
model_provider = "8848ai"

[model_providers.8848ai]
name = "8848AI"
base_url = "https://api.884819.xyz/v1"
env_key = "OPENAI_API_KEY"

启动测试：

codex

进入项目目录后，先发送一个简单任务：

请只回复 PONG，并说明当前使用的模型名称。

如果正常返回，说明 Codex 已经通过 8848AI API中转站调用成功。之后可以让 Codex 执行更复杂任务，例如：

请阅读这个项目，概括技术栈、启动命令和主要目录结构，不要修改文件。

常见问题：

现象	处理方法
仍然跳到官方登录	确认已设置 `OPENAI_API_KEY`，并且 `config.toml` 路径正确；改完后重启终端或 Codex。
`401` / `Unauthorized`	令牌错误、令牌被删除、没有复制完整；重新到控制台创建令牌。
`404` / 模型不存在	令牌分组不包含该模型，或模型名写错；先用 `/v1/models` 检查。
`429` / 频率限制	降低并发、等待一会儿重试，或换更高额度分组。
长任务中断	优先使用 `gpt-5.3-codex-spark` 或 `gpt-5.5`，并减少一次性提交的文件范围。

Codex App 或 IDE 插件如果支持填写 API Key 和自定义 Base URL，也使用同样参数；如果界面只支持 ChatGPT 官方登录、不支持自定义 Base URL，则不能直接接入 8848AI。

OpenClaw（龙虾）接入 8848AI

OpenClaw（龙虾）是本地/自托管 AI 助手，可以接入 Telegram、Discord、WhatsApp、网页控制台等通道。8848AI 作为 OpenAI 兼容中转站接入 OpenClaw 时，推荐把 8848AI 单独配置成一个自定义 provider，例如 8848ai。

安装 OpenClaw

OpenClaw 官方建议准备 Node.js，Node 24 优先，Node 22.14+ 也可用。安装命令如下：

macOS / Linux：

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

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

首次启动：

openclaw onboard --install-daemon

检查 Gateway：

openclaw gateway status
openclaw dashboard

配置 8848AI Provider

准备 8848AI 令牌：

API Key: sk-your-key
Base URL: https://api.884819.xyz/v1
Provider ID: 8848ai

推荐先把 Key 放进环境变量，避免把真实密钥写进配置文件。

macOS / Linux：

export API8848_KEY="sk-your-key"

Windows PowerShell：

$env:API8848_KEY="sk-your-key"

在 OpenClaw 的模型配置里加入自定义 provider。核心配置如下：

{
  agents: {
    defaults: {
      model: {
        primary: "8848ai/gpt-5.5",
        fallbacks: ["8848ai/gpt-5.4", "8848ai/gpt-4.1"]
      },
      imageGenerationModel: {
        primary: "8848ai/gpt-image-2"
      },
      models: {
        "8848ai/gpt-5.5": { alias: "8848AI GPT-5.5" },
        "8848ai/gpt-5.4": { alias: "8848AI GPT-5.4" },
        "8848ai/gpt-5.4-mini": { alias: "8848AI Mini" },
        "8848ai/gpt-5.3-codex-spark": { alias: "8848AI Codex" },
        "8848ai/gpt-4.1": { alias: "8848AI GPT-4.1" },
        "8848ai/gpt-image-2": { alias: "8848AI Image" }
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      "8848ai": {
        baseUrl: "https://api.884819.xyz/v1",
        apiKey: "${API8848_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-5.5", name: "GPT-5.5" },
          { id: "gpt-5.4", name: "GPT-5.4" },
          { id: "gpt-5.4-mini", name: "GPT-5.4 Mini" },
          { id: "gpt-5.3-codex-spark", name: "GPT-5.3 Codex" },
          { id: "gpt-4.1", name: "GPT-4.1" },
          { id: "gpt-image-2", name: "GPT Image 2", input: ["text", "image"] }
        ]
      }
    }
  }
}

配置完成后刷新模型：

openclaw models list --provider 8848ai
openclaw models set 8848ai/gpt-5.5
openclaw models status
openclaw gateway restart

在 OpenClaw 聊天窗口里也可以临时切换：

/model list
/model 8848ai/gpt-5.5
/model 8848ai/gpt-5.3-codex-spark
/model status

推荐模型：

场景	OpenClaw 模型引用
日常聊天、写作、翻译	`8848ai/gpt-5.5` / `8848ai/gpt-5.4`
低成本快速回复	`8848ai/gpt-5.4-mini`
代码、仓库分析、Agent 任务	`8848ai/gpt-5.3-codex-spark`
稳定备用	`8848ai/gpt-4.1`
图片生成	`8848ai/gpt-image-2`

注意：8848AI 的 OpenClaw 接入地址必须带 /v1：

https://api.884819.xyz/v1

OpenClaw 排错

现象	处理方法
`8848ai/*` 模型不出现在列表	检查 `models.providers.8848ai` 是否保存成功，执行 `openclaw models list --provider 8848ai`。
提示缺少认证	检查 `API8848_KEY` 环境变量是否生效，或确认配置中的 `apiKey` 是否指向 `${API8848_KEY}`。
`401` / `Unauthorized`	令牌错误、被删除或没有复制完整；重新到 8848AI 控制台创建 `sk-` 令牌。
`404` / 模型不存在	模型名写错，或令牌分组不支持该模型；先用 `/v1/models` 检查。
`Model is not allowed`	`agents.defaults.models` 开了允许列表，但没加入该模型；把 `8848ai/模型名` 加入允许列表或清空允许列表。
回复为空或路径错误	Base URL 没带 `/v1`，改成 `https://api.884819.xyz/v1`。
图片生成不可用	确认 `imageGenerationModel.primary` 使用 `8848ai/gpt-image-2`，并且令牌分组支持图片模型。

Hermes Agent 接入 8848AI

Hermes Agent 是终端 / 自托管 AI Agent 工具，支持通过 Custom endpoint 接入 OpenAI 兼容接口。AICodeMirror 用户可登录 https://www.aicodemirror.com/dashboard/hermes，在热门工具里找到 Hermes 配置教程；实际填写 8848AI 时，核心参数如下：

Provider: Custom endpoint
API base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model name: gpt-5.5

安装 Hermes

Linux / macOS / WSL2：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes --version

Windows 原生环境不建议直接安装，推荐先安装 WSL2，再在 WSL2 终端里执行上面的安装命令。

方式一：交互式接入

hermes model

按提示选择 Custom endpoint / Self-hosted，然后填写：

API base URL: https://api.884819.xyz/v1
API key: sk-your-key
Model name: gpt-5.5

配置完成后测试：

hermes chat -q "用一句话确认 8848AI 已成功接入 Hermes"

临时指定模型：

hermes chat -m gpt-5.3-codex-spark -q "检查当前项目结构并给出优化建议"

方式二：手动写入配置

推荐把密钥放在 ~/.hermes/.env，不要直接写进共享截图或教程：

API8848_KEY=sk-your-key

然后编辑 ~/.hermes/config.yaml：

model:
  provider: custom
  base_url: https://api.884819.xyz/v1
  api_key: "${API8848_KEY}"
  default: gpt-5.5

也可以用命令写入：

hermes config set model.provider custom
hermes config set model.base_url https://api.884819.xyz/v1
hermes config set model.api_key sk-your-key
hermes config set model.default gpt-5.5
hermes config check

如果你经常在多个中转站之间切换，可以把 8848AI 配成命名自定义提供商：

custom_providers:
  - name: 8848ai
    base_url: https://api.884819.xyz/v1
    key_env: API8848_KEY
    api_mode: chat_completions
    models:
      gpt-5.5:
        context_length: 128000
      gpt-5.4:
        context_length: 128000
      gpt-5.4-mini:
        context_length: 128000
      gpt-5.3-codex-spark:
        context_length: 128000
      gpt-4.1:
        context_length: 128000
      gemini-3.1-pro:
        context_length: 128000
      claude-opus-4.8:
        context_length: 200000

会话中切换命名 Provider：

/model custom:8848ai:gpt-5.5
/model custom:8848ai:gpt-5.3-codex-spark
/model custom:8848ai:gemini-3.1-pro

推荐模型：

场景	Hermes 填写模型
日常问答、写作、总结	`gpt-5.5` / `gpt-5.4`
低成本快速回复	`gpt-5.4-mini`
代码 Agent、仓库分析、自动修复	`gpt-5.3-codex-spark`
长文本、资料整理	`gemini-3.1-pro`
Claude 风格任务	`claude-opus-4.8` / `claude-sonnet-4.6`

注意：gpt-image-2 是图片生成模型，不建议填成 Hermes 的主聊天模型；图片生成请使用图片接口或支持自定义图片模型的工具面板。

Hermes 排错

现象	处理方法
配置后仍走 OpenRouter	执行 `hermes config set model.provider custom`，或重新运行 `hermes model` 选择 `Custom endpoint`。
`401` / `Unauthorized`	8848AI 令牌错误、过期或分组无权限，重新创建 `sk-` 令牌。
`404` / 模型不存在	模型名必须完整复制，例如 `gpt-5.3-codex-spark`，不要写成展示名。
连接失败或路径错误	Base URL 必须是 `https://api.884819.xyz/v1`，不要漏掉 `/v1`。
`/model` 里找不到 8848AI	`/model` 只能切换已配置 Provider；先退出会话，运行 `hermes model` 或写入 `custom_providers`。
Windows 安装失败	使用 WSL2 运行 Hermes，再按 Linux 命令安装。

8. Gemini 3.1 接入

本站 Gemini 3.1 已接入 OpenAI 兼容接口。客户不需要使用 Google 官方原生地址，直接按 OpenAI 兼容方式填写：

Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: gemini-3.1-pro

cURL 示例：

curl https://api.884819.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gemini-3.1-pro",
    "messages": [
      {"role": "user", "content": "用三句话介绍 Gemini 3.1"}
    ]
  }'

Python 示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://api.884819.xyz/v1",
)

response = client.chat.completions.create(
    model="gemini-flash-lite",
    messages=[{"role": "user", "content": "请回复 PONG"}],
)

print(response.choices[0].message.content)

如果客户端里有专门的 Gemini API / Google AI Studio 模式，它可能要求 Google 原生接口格式。本站当前推荐使用 OpenAI Compatible 模式接入 Gemini 3.1。

9. Claude 接入方式一：OpenAI 兼容接口

如果客户端支持 OpenAI 兼容协议，可以直接这样配置 Claude：

Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: claude-opus-4.8

cURL 示例：

curl https://api.884819.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "claude-opus-4.8",
    "messages": [
      {"role": "user", "content": "请用中文回复 PONG"}
    ]
  }'

这种方式适合 Cherry Studio、Chatbox、LobeChat、Open WebUI、Cline、Roo Code、Continue、NextChat 等支持 OpenAI 兼容地址的软件。

10. Claude 接入方式二：Anthropic Messages 接口

适合要求 Anthropic 原生格式的客户端。

cURL 示例：

curl https://api.884819.xyz/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "请回复 PONG"}
    ]
  }'

Python Anthropic SDK 示例：

pip install anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-key",
    base_url="https://api.884819.xyz",
)

message = client.messages.create(
    model="claude-opus-4.8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "请回复 PONG"}],
)

print(message.content[0].text)

11. Claude Code 接入

Claude Code 不要把 ANTHROPIC_BASE_URL 写成 /v1，应填写根地址：

https://api.884819.xyz

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.884819.xyz"
export ANTHROPIC_API_KEY="sk-your-key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.884819.xyz"
$env:ANTHROPIC_API_KEY="sk-your-key"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
claude

如果某些网关/客户端只认 Authorization: Bearer，可改用：

export ANTHROPIC_AUTH_TOKEN="sk-your-key"

不要同时长期保留多个不同 Key，避免实际请求走错令牌。

写入 Claude Code 设置文件

也可以写入 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.884819.xyz",
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

进入 Claude Code 后可运行：

/status
/model

用来检查当前接口、令牌和模型是否生效。

12. GPT Image 2 图片生成

cURL 示例：

curl https://api.884819.xyz/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张干净高级的商务头像海报，白色背景，真实摄影风格",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Python 保存图片：

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://api.884819.xyz/v1",
)

image = client.images.generate(
    model="gpt-image-2",
    prompt="一张干净高级的商务头像海报，白色背景，真实摄影风格",
    size="1024x1024",
    n=1,
)

item = image.data[0]
if getattr(item, "b64_json", None):
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(item.b64_json))
else:
    print(item.url)

注意：gpt-image-2 当前不支持透明背景，图片需求里不要写 background: transparent。

13. 图片理解 / 多模态输入

带 Vision 标签的 GPT、Claude、Gemini 模型可以处理图片输入。OpenAI 兼容格式示例：

curl https://api.884819.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "请描述这张图片"},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'

本地图片可先转成 Base64 Data URL，再放入 image_url.url。

14. Responses API 可选接入

部分 OpenAI 兼容客户端会使用 Responses API。若客户端支持自定义地址，可尝试：

curl https://api.884819.xyz/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-5.5",
    "input": "请回复 PONG"
  }'

如果 Responses API 报错，优先切回 /v1/chat/completions，这是目前兼容范围最广的调用方式。

15. 常见软件填写方式

Cherry Studio / Chatbox / NextChat / LobeChat

Provider: OpenAI Compatible
API Host / Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: gpt-5.5 / gpt-5.4 / gemini-3.1-pro / claude-opus-4.8

Open WebUI

OPENAI_API_BASE_URL=https://api.884819.xyz/v1
OPENAI_API_KEY=sk-your-key

在模型列表里手动添加或刷新：

gpt-5.5
gpt-5.4
gpt-5.3-codex-spark
gemini-3.1-pro
claude-opus-4.8

Cline / Roo Code / Continue

优先选择：

Provider: OpenAI Compatible
Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model ID: claude-opus-4.8 或 gpt-5.3-codex-spark

如果工具有 Anthropic 原生模式，Claude 模型也可使用：

Anthropic Base URL: https://api.884819.xyz
Anthropic API Key: sk-your-key
Model: claude-opus-4.8

Cursor / Windsurf 等 IDE

如果支持自定义 OpenAI 地址：

OpenAI Compatible Base URL: https://api.884819.xyz/v1
API Key: sk-your-key
Model: gpt-5.3-codex-spark

编程优先推荐 gpt-5.3-codex-spark、claude-opus-4.8、claude-sonnet-4.6。

16. 实用 Skill：稳定调用与高质量输出

下面这些 Skill 可以直接复制给用户，也可以放进 Cherry Studio、Chatbox、Claude Code、Cline、Roo Code、Continue 等工具的系统提示词里。核心思路来自 OpenAI、Anthropic、Google 官方实践：先确认令牌可用，再明确任务、输入、限制、输出格式和验收方式。

Skill 1：令牌三步自检

适合新用户第一次接入，或客户反馈“用不了”时快速定位。

先看令牌能看到哪些模型：

curl https://api.884819.xyz/v1/models \
  -H "Authorization: Bearer sk-your-key"

再用最短文本测试基础调用：

curl https://api.884819.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "只回复 PONG"}
    ],
    "stream": false
  }'

最后再切到目标模型。若第二步成功、第三步失败，通常是模型名、分组权限、上游拥堵或额度问题。

Skill 2：按任务选择模型

场景	推荐模型	用法
日常问答、客服、短文案	`gpt-5.4-mini` / Gemini Flash 类模型	速度优先，成本更低
高质量长文、复杂分析	`gpt-5.5` / `gpt-5.4` / `gemini-3.1-pro`	质量优先，适合长任务
编程、Agent、IDE 插件	`gpt-5.3-codex-spark` / `claude-opus-4.8` / `claude-sonnet-4.6`	要求模型先读上下文、再执行和自测
图片生成、商业海报	`gpt-image-2`	提示词写清主体、构图、背景、文字规则
图片理解、多模态分析	带 Vision 能力的 GPT / Claude / Gemini 模型	图片用 URL 或 Base64 Data URL

Skill 3：通用高质量提示词模板

你是：[角色，例如资深产品经理 / 法律合同审阅助手 / 高级平面设计师]

目标：
[一句话说明最终要完成什么]

输入：
[粘贴资料、图片说明、表格、客户需求或代码片段]

限制：
1. 不要编造不存在的信息。
2. 不确定的地方标注“需要确认”。
3. 保持语言简洁，优先给可执行结论。

输出格式：
1. 先给结论。
2. 再给步骤或表格。
3. 最后给风险点和下一步建议。

检查：
回答前自查是否遗漏输入中的关键约束。

Skill 4：JSON / 表格提取

适合订单分析、客户资料整理、模型列表同步、接口返回清洗。

请从下面文本中提取结构化信息。只输出合法 JSON，不要 Markdown，不要解释。

字段：
- name: 字符串
- email: 字符串，缺失时填 null
- amount: 数字，缺失时填 null
- status: one of ["paid", "unpaid", "unknown"]
- risk: one of ["normal", "suspicious", "need_check"]

文本：
[粘贴内容]

如果客户端支持 response_format，可先用 JSON 模式：

{
  "response_format": {
    "type": "json_object"
  }
}

复杂业务建议在程序侧继续用 JSON Schema 校验，失败时自动重试一次，并把错误原因写进下一次提示词。

Skill 5：代码与 Agent 工作流

适合 Claude Code、Cline、Roo Code、Continue、Cursor、Windsurf。

请按下面流程完成任务：
1. 先阅读相关文件和配置，说明你理解到的现状。
2. 给出简短计划，列出要改哪些文件和为什么。
3. 实现时保持改动范围最小，不改无关文件。
4. 完成后运行可用的测试、lint 或最小验证命令。
5. 最后输出：改了什么、验证结果、剩余风险。

任务：
[写清要实现/修复的内容]

Claude Code 类工具建议遵循“探索 -> 计划 -> 实现 -> 验证”。长会话里如果连续纠错两次还跑偏，使用 /clear 或开新会话，把已确认的信息重新组织成更短的提示词。

Skill 6：`gpt-image-2` 商业出图模板

请生成一张高清写实商业图片。

主体：[人物 / 产品 / 场景]
用途：[头像海报 / 电商主图 / 宣传图 / 信息图]
构图：[正面半身 / 居中 / 俯拍 / 留白区域]
背景：[纯白 / 办公室 / 科技感但不杂乱]
光线：[柔和均匀 / 专业棚拍 / 自然阴影]
风格：[真实摄影 / 高级商务 / 干净简洁]
文字规则：[如需要文字，写清英文内容、层级、颜色和位置]
不要：[不要透明背景，不要水印，不要多余文字，不要夸张变形]
比例：[1:1 / 16:9 / 9:16]

如果客户端有质量选项，草稿可选低质量以节省时间；最终商业图再用中高质量。人物编辑类需求要强调“保留身份特征、五官比例和真实气质”，避免把人物改成另一个人。

Skill 7：Gemini 3.1 长文与多模态

请基于我提供的资料回答，不要脱离资料发挥。

任务：
[总结 / 提取表格 / 翻译 / 对比 / 生成方案]

资料：
[粘贴文本、图片说明或文档片段]

要求：
1. 先给 3 条以内结论。
2. 再列证据或引用位置。
3. 如果资料不足，直接说还缺什么。
4. 输出为表格或编号列表。

复杂任务不要一次塞太多要求。先让模型“提取事实”，第二轮再“分析和生成方案”，第三轮再“润色成最终稿”，稳定性会更好。

Skill 8：成本、速度与稳定性控制

调试阶段先用 gpt-5.4-mini 或 Flash 类模型，确认提示词有效后再换高质量模型。
接口排错先设 stream: false，确认成功后再开流式输出。
长提示词把固定规则放前面，把每次变化的客户资料、订单、文章放最后；支持缓存的上游更容易节省延迟和费用。
设置合理的 max_tokens，摘要、分类、JSON 提取不要放任模型无限长输出。
遇到 502 upstream_error 先换同系列模型重试，例如 gpt-5.5 换 gpt-5.4，或 Gemini Pro 换 Flash。
不要把完整 API Key 发给客服、群聊或截图；排查只保留前后 4 位。

Skill 9：客服一键排查话术

请按顺序发我这 4 项信息：
1. 你填写的 Base URL，注意不要发完整 Key。
2. 你选择的模型 ID。
3. 报错截图或完整错误码。
4. 你用的是哪个软件：Cherry Studio / Chatbox / Claude Code / Cline / Cursor / 其他。

先不要反复重试大任务，我会先用 /v1/models 和 PONG 测试帮你判断是 Key、分组、模型名、余额还是上游问题。

17. 排错表

现象	常见原因	处理方式
`401 unauthorized`	Key 错误、令牌被删除、认证头不匹配	重新复制 Key；OpenAI 用 `Authorization: Bearer`；Anthropic 用 `x-api-key` 或 `ANTHROPIC_API_KEY`
`403` / 无权限	令牌分组不包含该模型	确认令牌使用 `default` 分组
`model not found`	模型名拼错或该令牌不可见	用 `/v1/models` 查看实际可用模型，复制完整模型 ID
`insufficient quota`	余额不足或额度不足	充值或更换有余额令牌
`502 upstream_error`	上游临时异常或模型拥堵	换同系列模型重试，例如 `gpt-5.5` 换 `gpt-5.4`
Claude Code 404	`ANTHROPIC_BASE_URL` 写成了 `/v1`	改成 `https://api.884819.xyz`
Gemini 客户端报格式错误	使用了 Google 原生 Gemini 模式	改用 `OpenAI Compatible`，Base URL 填 `/v1`
图片透明背景报错	`gpt-image-2` 不支持透明背景	删除透明背景参数，使用白底或纯色背景
流式输出卡住	客户端或网络不支持流式	先设置 `stream: false` 测试基础调用

18. 客服快速话术

给客户最短版：

接口地址：https://api.884819.xyz/v1
类型：OpenAI Compatible
Key：填写你的 sk- 开头令牌
模型：gpt-5.5 / gpt-5.4 / gpt-5.3-codex-spark / gemini-3.1-pro / claude-opus-4.8

Claude Code 用户：

ANTHROPIC_BASE_URL=https://api.884819.xyz
ANTHROPIC_API_KEY=你的 sk- 令牌
推荐模型：claude-opus-4.8 或 claude-sonnet-4.6

图片生成用户：

接口地址：https://api.884819.xyz/v1/images/generations
模型：gpt-image-2
尺寸：1024x1024

19. 安全建议

每个客户或每个业务单独创建令牌。
令牌只放在服务端或本地客户端，不放浏览器前端。
文档、截图、客服聊天里不要展示完整 Key。
发现泄露后立即删除令牌并重新生成。
长期业务建议按用途单独创建令牌，便于统计和限额；分组统一使用 default。

20. 官方参考资料

OpenAI 自定义兼容端点说明：https://developers.openai.com/api/docs/guides/external-models#custom-endpoints
OpenAI Chat Completions API：https://developers.openai.com/api/reference/resources/chat
OpenAI 图片生成说明：https://developers.openai.com/api/docs/guides/images-vision#generate-or-edit-images
OpenAI 图片工具参数说明：https://developers.openai.com/api/docs/guides/tools-image-generation#tool-options
OpenAI 提示工程：https://developers.openai.com/api/docs/guides/prompt-engineering
OpenAI 结构化输出：https://developers.openai.com/api/docs/guides/structured-outputs
OpenAI GPT Image 提示词指南：https://developers.openai.com/cookbook/examples/multimodal/image-gen-models-prompting-guide
OpenAI Codex 快速开始：https://developers.openai.com/codex/quickstart
OpenAI Codex 配置参考：https://developers.openai.com/codex/config-reference
OpenClaw 快速开始：https://docs.openclaw.ai/start/getting-started
OpenClaw OpenAI Provider：https://docs.openclaw.ai/providers/openai
OpenClaw 自定义模型 Provider：https://docs.openclaw.ai/concepts/model-providers
OpenClaw models 命令：https://docs.openclaw.ai/cli/models
AICodeMirror Hermes 配置教程（登录后进入热门工具）：https://www.aicodemirror.com/dashboard/hermes
Hermes Agent 官方安装：https://hermes-agent.nousresearch.com/docs/getting-started/installation
Hermes Agent 配置说明：https://hermes-agent.nousresearch.com/docs/user-guide/configuration
Hermes Agent AI Providers：https://hermes-agent.nousresearch.com/docs/integrations/providers
Gemini OpenAI 兼容接口说明：https://ai.google.dev/gemini-api/docs/openai
Gemini 提示词策略：https://ai.google.dev/gemini-api/docs/prompting-strategies
Gemini 结构化输出：https://ai.google.dev/gemini-api/docs/structured-output
Gemini 文本生成与流式输出：https://ai.google.dev/gemini-api/docs/text-generation
Anthropic Messages API 示例：https://platform.claude.com/docs/en/build-with-claude/working-with-messages
Anthropic Claude 提示工程：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview
Claude Code 最佳实践：https://code.claude.com/docs/en/best-practices
Claude Code 环境变量：https://code.claude.com/docs/en/env-vars
Claude Code LLM Gateway 配置：https://code.claude.com/docs/en/llm-gateway
Claude Code 模型配置：https://code.claude.com/docs/en/model-config

8848AI API中转站使用教程与接入文档

8848AI API中转站使用教程与接入文档

1. 快速接入信息

接入前 30 秒检查

2. 创建令牌

3. 网站注册、兑换与使用教程

3.1 注册登录

3.2 兑换码使用

3.3 在线充值

3.4 使用顺序

4. 分组选择

5. 推荐模型列表

Claude（首推）

Grok

GPT 文本/代码模型

GPT 图片生成

Gemini

6. 检查令牌可用模型

7. OpenAI 兼容聊天接口

cURL

Python

Node.js

流式输出

Codex CLI 接入 8848AI

OpenClaw（龙虾）接入 8848AI

安装 OpenClaw

配置 8848AI Provider

OpenClaw 排错

Hermes Agent 接入 8848AI

安装 Hermes

方式一：交互式接入

方式二：手动写入配置

Hermes 排错

8. Gemini 3.1 接入

9. Claude 接入方式一：OpenAI 兼容接口

10. Claude 接入方式二：Anthropic Messages 接口

11. Claude Code 接入

macOS / Linux

Windows PowerShell

写入 Claude Code 设置文件

12. GPT Image 2 图片生成

13. 图片理解 / 多模态输入

14. Responses API 可选接入

15. 常见软件填写方式

Cherry Studio / Chatbox / NextChat / LobeChat

Open WebUI

Cline / Roo Code / Continue

Cursor / Windsurf 等 IDE

16. 实用 Skill：稳定调用与高质量输出

Skill 1：令牌三步自检

Skill 2：按任务选择模型

Skill 3：通用高质量提示词模板

Skill 4：JSON / 表格提取

Skill 5：代码与 Agent 工作流

Skill 6：gpt-image-2 商业出图模板

Skill 7：Gemini 3.1 长文与多模态

Skill 8：成本、速度与稳定性控制

Skill 9：客服一键排查话术

17. 排错表

18. 客服快速话术

19. 安全建议

20. 官方参考资料

Skill 6：`gpt-image-2` 商业出图模板