Client Setup

常用客户端配置

大多数客户端只需要三项配置：令牌、Base URL 和模型名。先在控制台创建令牌并复制 sk-xxxxxxxx，再把客户端的服务地址改成 https://youlai.ai/ 或 https://youlai.ai/v1。

配置前准备

登录 https://youlai.ai/console，确认账户已有可用额度。
在“令牌”页面创建并复制 sk-xxxxxxxx。
在控制台确认要使用的 gpt-5.5 已开放。
确认客户端支持自定义 Base URL 或自定义 OpenAI/Anthropic 兼容服务。

令牌	`sk-xxxxxxxx`，用于鉴权。OpenAI 兼容接口通常放在 `Authorization: Bearer`，Claude 兼容接口通常放在 `x-api-key`。
OpenAI Base URL	`https://youlai.ai/v1`。OpenAI SDK、Chatbox、Cherry Studio、Cline、Roo Code、Continue 等常用这个地址。
Claude Base URL	`https://youlai.ai/` 或客户端要求的 Claude 兼容服务地址。最终路径通常由客户端拼接到 `/v1/messages`。
模型名	`gpt-5.5`，必须与控制台开放模型名称一致，大小写和前后空格都要准确。

支持的客户端类型

只要客户端支持自定义 OpenAI 兼容或 Anthropic 兼容服务，就可以优先按下面方式接入。

Codex CLI命令行编码助手

Claude CodeClaude 兼容命令行工具

Cherry Studio桌面聊天客户端

Chatbox / NextChatOpenAI 兼容聊天客户端

Cline / Roo CodeVS Code 编码插件

Cursor / Continue编辑器 AI 插件

DifyAI 应用编排平台

n8n自动化工作流

OpenAI SDKPython / Node.js 业务代码

Codex CLI

创建或编辑 ~/.codex/youlai.config.toml。
把 base_url 设置为 https://youlai.ai/v1。
把 env_key 设置为保存令牌的环境变量名。
启动时使用 codex -p youlai 加载这个 profile。

model_provider = "youlai"
model = "gpt-5.5"

[model_providers.youlai]
name = "又来AI"
base_url = "https://youlai.ai/v1"
env_key = "YOULAI_API_KEY"
wire_api = "responses"
query_params = {}
request_max_retries = 4
stream_max_retries = 10

启动和验证

export YOULAI_API_KEY="sk-xxxxxxxx"
codex -p youlai "用一句话说明当前目录的项目用途"

如果模型或 Codex CLI 版本不支持 Responses 格式，可改用该 CLI 支持的兼容格式，并选择控制台中可用的模型。

Claude Code / Claude 类客户端

又来AI 当前按平台内置能力提供 POST /v1/messages Claude 兼容路由，用户侧不需要单独启用。配置重点是让客户端请求 https://youlai.ai/，并携带 x-api-key 或客户端对应的鉴权令牌配置。

确认你的客户端支持自定义 Anthropic/Claude 兼容 Base URL。
设置鉴权令牌为 sk-xxxxxxxx。
设置服务地址为 https://youlai.ai/，不要重复拼接 /v1/messages，除非客户端明确要求填写完整路径。
设置模型名为控制台开放的 Claude 兼容模型，例如 gpt-5.5。

export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
export ANTHROPIC_BASE_URL="https://youlai.ai/"
export ANTHROPIC_MODEL="gpt-5.5"

claude

Claude Code CLI 调用 Opus 4.6 报 invalid beta flag

较新的 Claude Code CLI 会自动附带一组实验性 anthropic-beta 请求头。部分 Claude 兼容上游不接受这些实验标记，调用 claude-opus-4-6 等模型时可能返回 invalid beta flag。这种情况下，将下面的环境变量写入用户级 Claude Code 配置即可：

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

配置文件路径为 ~/.claude/settings.json。保存后重新启动 claude，再按客户端要求设置 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 即可。

export ANTHROPIC_BASE_URL="https://youlai.ai/"
export ANTHROPIC_API_KEY="sk-xxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-4-6"

claude --model claude-opus-4-6

不同 Claude 类客户端对变量名可能不同。有的使用 ANTHROPIC_API_KEY，有的使用 ANTHROPIC_AUTH_TOKEN。如果启动后仍访问官方地址，请检查客户端文档中的代理或 Base URL 变量名。

Cherry Studio / Chatbox / NextChat

打开客户端设置，进入“模型服务”“Provider”或“自定义模型服务”。
新增一个 OpenAI 兼容服务，名称填写 又来AI。
令牌字段填写 sk-xxxxxxxx。
API 地址或 Base URL 填写 https://youlai.ai/v1。
手动添加 gpt-5.5，或点击客户端的“获取模型 / 刷新模型”。
保存后新建会话，选择刚添加的模型，发送“你好”测试。

Provider 类型	OpenAI Compatible / 自定义 OpenAI / OpenAI 兼容
令牌	`sk-xxxxxxxx`
Base URL	`https://youlai.ai/v1`
模型	`gpt-5.5`

Cline / Roo Code

在 VS Code 打开 Cline 或 Roo Code 设置。
Provider 选择 OpenAI Compatible、OpenAI API Compatible 或自定义 OpenAI 服务。
Base URL 填写 https://youlai.ai/v1。
令牌字段填写 sk-xxxxxxxx。
Model ID 填写 gpt-5.5。
保存后用一个简单任务测试，例如“读取当前文件并总结”。

如果插件要求分别配置“模型 ID”和“显示名称”，模型 ID 必须与控制台实际模型名一致，显示名称可以自定义。

Cursor / Continue

Cursor

打开 Cursor 设置中的 Models 或鉴权配置页面。
启用自定义 OpenAI 兼容服务。
填写令牌：sk-xxxxxxxx。
填写 Base URL：https://youlai.ai/v1。
添加或选择模型：gpt-5.5。

Continue

Continue 通常通过配置文件添加 OpenAI 兼容模型：

{
  "models": [
    {
      "title": "又来AI",
      "provider": "openai",
      "model": "gpt-5.5",
      "apiBase": "https://youlai.ai/v1",
      "apiKey": "sk-xxxxxxxx"
    }
  ]
}

不要把真实令牌提交到项目仓库。Continue 等工具如果支持环境变量，请优先使用环境变量。

Dify

进入 Dify 管理后台，打开“模型供应商”或“模型提供商”。
选择 OpenAI API-compatible 或自定义 OpenAI 兼容供应商。
令牌字段填写 sk-xxxxxxxx。
API Base 填写 https://youlai.ai/v1。
添加模型 gpt-5.5，并按需要设置上下文长度、最大输出等参数。
在应用中选择该模型，运行一次简单对话测试。

n8n / 自动化工作流

在 n8n 中创建 OpenAI 凭据或 HTTP Request 节点。
如果使用 OpenAI 节点，Base URL 填写 https://youlai.ai/v1，令牌字段填写 sk-xxxxxxxx。
如果使用 HTTP Request 节点，请手动添加请求头 Authorization: Bearer sk-xxxxxxxx。
请求地址使用 https://youlai.ai/v1/chat/completions。
Body 中填写 model 和 messages，结构见“调用示例”。

验证配置是否成功

发送一条最短消息，例如“你好”。
如果客户端能收到模型回复，说明 Base URL、令牌和模型名都正确。
如果失败，先复制客户端报错，再去“排障与安全”页面按错误码处理。

curl "https://youlai.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'