使用文档

MeridianAI 是一站式 AI 中转 API 服务。本文档涵盖 Claude 中转、GPT 中转、Gemini 中转、Grok 中转的完整接入方式，原生兼容 OpenAI 与 Anthropic 协议，支持 Claude Code、Cursor、Codex、Cherry Studio 等主流客户端，无需修改业务代码即可接入。

快速开始

只需两步：在控制台创建令牌，然后将客户端的 Base URL 替换为 MeridianAI 地址即可。

获取 API Key

登录 MeridianAI 控制台
点击左侧「令牌管理」→「创建令牌」
根据需要使用的模型选择对应分组（参考下方分组说明）
复制生成的 sk-xxx... 密钥

💡 每个令牌只能访问所选分组内的模型，请根据实际需求选择分组。如需同时使用多个厂商的模型，可创建多个令牌。

cURL

# OpenAI 兼容格式（适用于 Claude、GPT、Gemini、Grok）
curl https://www.meridiangolf.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

# Anthropic 原生格式（仅 Claude 系列）
curl https://www.meridiangolf.xyz/v1/messages \
  -H "Authorization: Bearer sk-xxx..." \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python · OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx...",
    base_url="https://www.meridiangolf.xyz/v1"
)

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

Python · Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-xxx...",
    base_url="https://www.meridiangolf.xyz"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxx...",
  baseURL: "https://www.meridiangolf.xyz/v1",
});

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

Claude Code

在新终端窗口通过环境变量接入，不影响当前 Claude Code 的登录状态：

# 新开一个终端 tab，执行以下命令
HOME=$(mktemp -d) \
ANTHROPIC_BASE_URL=https://www.meridiangolf.xyz \
ANTHROPIC_API_KEY="sk-xxx..." \
claude

💡 HOME=$(mktemp -d) 创建独立临时目录，完全隔离，退出后自动废弃，不影响现有 Claude 登录状态。令牌需选择 CC 官方或 W 独家分组。

分组说明

创建令牌时选择分组，决定该 Key 可访问的模型范围和计费倍率。

Claude 分组

分组	主要模型	倍率	说明
CC 官方	claude-sonnet-4-6、claude-haiku-4-5	1×	稳定官方渠道，日常对话、写作、代码
W 独家	claude-opus-4-7	1.5×	独家反代，最强推理，复杂任务首选

GPT 分组

分组	主要模型	倍率	说明
Codex Plus 稳定	gpt-5.4、gpt-5.3-codex、gpt-5.2	1×	稳定通道，代码生成、工具调用
GPT 全PRO 稳定	gpt-5.5、gpt-5.4、gpt-5.2-pro	1.5×	稳定通道，旗舰模型，高质量输出
Codex Plus 福利	gpt-5.4、gpt-5.3-codex、gpt-5.2	0.3×	限时福利低价通道，性价比首选
GPT 全PRO 福利	gpt-5.5、gpt-5.4、gpt-5.2-pro	0.6×	限时福利低价通道，旗舰模型低价享

其他分组

分组	主要模型	倍率	说明
Gemini W	gemini-2.5-pro、gemini-2.0-flash	1×	百万上下文，多模态，长文档处理
Grok W	grok-3、grok-3-mini	1×	实时网络搜索，时事分析

⚠️ 福利通道为限时优惠，可能随时调整，建议优先体验稳定通道。

Claude 系列

Anthropic 出品，擅长长文分析、代码理解、复杂推理，支持 OpenAI 及原生 Anthropic 两种接口格式。

模型 ID	上下文	所属分组	特点
`claude-sonnet-4-6`	200K	CC 官方	主力推荐，速度与质量均衡
`claude-haiku-4-5`	200K	CC 官方	极速轻量，高频简单任务
`claude-opus-4-7`	200K	W 独家	最强推理，复杂任务首选

GPT 系列

OpenAI 出品，代码生成和工具调用能力突出，支持函数调用（Function Calling）和结构化输出（JSON mode）。

模型 ID	上下文	特点
`gpt-5.5`	128K	旗舰最强，复杂推理与生成（全PRO分组）
`gpt-5.4`	128K	高阶均衡，推荐日常使用
`gpt-5.3-codex`	128K	代码专项优化，编程首选
`gpt-5.2`	128K	轻量高效，成本最低
`gpt-5.4-mini`	128K	迷你版，极低成本快速响应

Gemini 系列

Google DeepMind 出品，原生多模态，支持超长上下文，适合长文档、图片分析。

模型 ID	上下文	特点
`gemini-2.5-pro`	1M	旗舰级，百万上下文，多模态
`gemini-2.0-flash`	1M	速度最快，日常多模态任务

Grok 系列

xAI 出品，具备实时网络搜索能力，适合需要最新信息的场景。

模型 ID	上下文	特点
`grok-3`	131K	旗舰，实时搜索，推理能力强
`grok-3-mini`	131K	轻量快速，简单查询与摘要

常见问题

提示 401 / Invalid token

确认 API Key 格式正确（以 sk- 开头），令牌未过期，且所用模型在该令牌分组范围内。例如使用 claude-opus-4-7 需选择 W 独家分组。

提示额度不足 / 403

账号余额不足，请联系微信 jipingxieku 充值。

请求返回 400 / 模型不存在

检查模型 ID 拼写，参考上方模型列表中的确切 ID（区分大小写、连字符）。

流式输出一次性全部返回

客户端或中间层可能开启了缓冲。用 curl 验证：

curl -N https://www.meridiangolf.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx..." \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"hi"}],"stream":true}'

正常结果：每隔几十毫秒逐行出现 data: {...}，最后一行 data: [DONE]。

联系我们

技术支持、充值、合作咨询，请加微信：jipingxieku