开发者接入指南

本文面向开发者和第一次接 API 的用户，说明如何把 Xmodel 接入代码、开发工具和常见 AI 客户端。

⚠️ 注意：所有代码示例均使用 XMODEL_API_KEY 作为占位符，请勿在公开场合暴露真实 Token。

2.1 API 接口规范与兼容性说明

核心配置项

配置项	推荐填写	说明
API Key / Token	Xmodel「令牌管理」中复制的 Token	用于请求鉴权
Base URL	https://api.xmodel.pro/v1	OpenAI 兼容客户端通常填写带 /v1 的地址
Model ID	gpt-5.5、gpt-5.4、gpt-image-2 等	以模型广场或 /v1/models 返回为准

支持的 OpenAI 兼容接口

能力	接口	用途
对话补全	POST /v1/chat/completions	聊天、问答、代码生成
图片生成	POST /v1/images/generations	文生图
图片编辑	POST /v1/images/edits	图生图、局部重绘
模型列表	GET /v1/models	查询可用模型 ID

鉴权格式

2.2 通过主流客户端使用 Xmodel

接入前准备

进入 令牌管理 创建 Token。

打开 模型与价格 选择模型 ID。

准备 Base URL：**https://api.xmodel.pro/v1**。

配置完成后，到 使用日志 检查是否产生请求。

2.2.1 Cursor 接入 Xmodel 配置教程

配置步骤

打开 Cursor。

进入 Settings / Models / API Keys。

找到 OpenAI Compatible 或自定义 OpenAI 接口配置。

API Key 填写 Xmodel Token。

Base URL 填写：

https://api.xmodel.pro/v1

Model 填写模型 ID，例如：

gpt-5.5

保存后发送测试问题。

如果失败

401：检查 Token 是否正确。

404：检查模型 ID 是否存在。

没有请求记录：重启 Cursor，并确认配置已保存。

2.2.2 Chatbox / NextChat 接入配置教程

Chatbox 配置

打开 Chatbox 设置。

模型提供方选择 OpenAI 或 OpenAI Compatible。

API Key 填写 Xmodel Token。

API Host / Base URL 填写：

https://api.xmodel.pro/v1

模型名 填写 gpt-5.5 或其他可用模型 ID。

NextChat 配置

⚠️ 注意：不同版本 NextChat 的环境变量名称可能略有差异，如页面中出现 接口地址、代理地址、自定义接口，一般都对应 Base URL。

2.2.3 Codex 接入 Xmodel 教程

Mac / Linux 配置

编辑 ~/.codex/config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.xmodel.pro/v1"
wire_api = "responses"
requires_openai_auth = true

编辑 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "XMODEL_API_KEY"
}

Windows 配置

编辑 %userprofile%\.codex\auth.json：

{
  "OPENAI_API_KEY": "XMODEL_API_KEY",
  "auth_mode": "apikey"
}

配置后关闭并重新打开终端。

2.2.4 Claude Code 接入 Xmodel 教程

Mac / Linux 临时配置

settings.json 配置

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xmodel.chat",
    "ANTHROPIC_AUTH_TOKEN": "XMODEL_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

⚠️ 注意：Claude Code 的 ANTHROPIC_BASE_URL 通常不带 /v1。

2.3 代码调用示例

cURL 示例

Node.js 示例

2.4 常见报错代码与排查指南

401 Unauthorized

通常是 API Key 填错、Token 已禁用或请求头格式不正确。

404 Model Not Found

通常是 Model ID 不存在，或当前 Token 不允许调用该模型。

429 Rate Limit

通常是请求太频繁，建议降低并发、增加重试等待或切换备用模型。

技术支持与社群

💡 没找到答案？加入官方社群获取 1V1 支持

如果您在接入或推广过程中遇到任何技术问题，欢迎加入 Xmodel用户交流群。我们的技术专家和运营团队将在群内为您提供快速解答。

⚠️ 注意：请备注 “您的公司/职业”。

开发者接入指南

2.1 API 接口规范与兼容性说明#

核心配置项#

支持的 OpenAI 兼容接口#

鉴权格式#

2.2 通过主流客户端使用 Xmodel#

接入前准备#

2.2.1 Cursor 接入 Xmodel 配置教程#

配置步骤#

如果失败#

2.2.2 Chatbox / NextChat 接入配置教程#

Chatbox 配置#

NextChat 配置#

2.2.3 Codex 接入 Xmodel 教程#

Mac / Linux 配置#

Windows 配置#

2.2.4 Claude Code 接入 Xmodel 教程#

Mac / Linux 临时配置#

settings.json 配置#

2.3 代码调用示例#

cURL 示例#

Node.js 示例#

2.4 常见报错代码与排查指南#

401 Unauthorized#

404 Model Not Found#

429 Rate Limit#

技术支持与社群#