开发者 API 总览：OpenAI 兼容为主，Claude 原生按根地址

开发者接入路线：先证明链路，再写业务代码

第一次接入不要直接进项目里大改配置。先用最小请求证明“协议、令牌、模型、真实生成”都可用，再把同样配置写进业务代码。

接入结论

• OpenAI 兼容 Base URL：https://www.6xin.cc/v1
• Anthropic Messages Base URL：https://www.6xin.cc
• 认证方式：API 认证与令牌 里有 Bearer Token、x-api-key 和服务端保存方式。
• 模型 ID：从模型广场复制，或按 模型列表与可见性 请求 GET /v1/models。
• 图像和视频接口也走 https://www.6xin.cc/v1，但要使用对应能力的模型 ID。
• 生产应用：令牌只放服务端，不要暴露给浏览器。

本章导航

如果你已经知道自己要接哪种协议，可以直接跳到对应段落。第一次接入建议按顺序看完，再复制示例代码。

6星中转 便利能力与边界

6星中转 的 API 设计目标是让常见工具和代码尽量沿用原有 SDK。下面这些能力可以帮你少写粘合代码，但仍然要按模型分组、接口协议和安全边界来验收。

平台兼容的接口格式

常用接口速查

先按能力选接口，再按模型广场选择对应模型。不要拿聊天模型去调用图像或视频接口，也不要只用模型列表当作成功依据。

30 秒跑通

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

返回 JSON 里如果能看到 choices[0].message.content，说明基础接入成功。

查询模型列表

/v1/models 可以用来确认当前令牌能访问哪些模型。

curl "https://www.6xin.cc/v1/models" \
  -H "Authorization: Bearer sk-你的令牌"

排查时的停止点

下面这些情况不要继续往业务代码里叠配置。先在最小请求层面把问题定位清楚，再回到项目里改代码。

业务接入改坏后，先退回最小链路

当本地 curl 能跑、业务代码却失败时，不要连续改 SDK、模型、令牌和部署变量。先退回一个可证明的最小链路，再把业务代码的变量逐项加回来。

图像和视频示例

图像和视频任务通常比聊天更容易受模型分组、文件大小、异步任务状态影响。第一次测试时先用短 prompt、低并发、测试令牌。

文生图最小请求

curl "https://www.6xin.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "图像模型ID",
    "prompt": "一只绿色玻璃质感的字母 C 图标，白色背景",
    "size": "1024x1024"
  }'

图像编辑上传本地文件

curl "https://www.6xin.cc/v1/images/edits" \
  -H "Authorization: Bearer sk-你的令牌" \
  -F "model=图像编辑模型ID" \
  -F "prompt=把图片背景改成浅色工作台" \
  -F "image=@./input.png"

视频生成和查询

curl "https://www.6xin.cc/v1/videos" \
  -H "Authorization: Bearer sk-你的令牌" \
  -F "model=视频模型ID" \
  -F "prompt=一个 6星中转 标志从屏幕中央轻微发光出现" \
  -F "seconds=5"

curl "https://www.6xin.cc/v1/videos/任务ID" \
  -H "Authorization: Bearer sk-你的令牌"

SDK 通用提示

6星中转 尽量保持主流 SDK 的原有用法。第一次接入时，不要急着改业务代码，先把“地址、令牌、模型、真实请求”四件事确认清楚。

SDK 示例

主流 SDK 不需要改调用方式，关键是把客户端初始化里的地址换成 6星中转，并确认令牌在服务端读取。

export COMEU_API_KEY="sk-你的令牌"

Python OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMEU_API_KEY"],
    base_url="https://www.6xin.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[{"role": "user", "content": "回复 OK"}],
)

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

Node.js OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMEU_API_KEY,
  baseURL: "https://www.6xin.cc/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4.1-mini",
  messages: [{ role: "user", content: "回复 OK" }],
});

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

Anthropic Messages 口径

curl "https://www.6xin.cc/v1/messages" \
  -H "x-api-key: sk-你的令牌" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-示例模型",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

错误码速查

生产接入建议

• 所有令牌只保存在服务端环境变量或密钥管理服务里。
• 为生产、测试、本地分别创建令牌，避免共用。
• 请求日志只记录模型、状态码、耗时和脱敏令牌片段。
• 图像、视频和长上下文请求单独设置超时、队列和并发上限。
• 对 429 和 5xx 做退避重试，不要无间隔重放。
• 上线前用真实模型请求验证，而不是只请求 /v1/models。

开发者接入验收清单

出问题时先分流，不要直接改业务代码

开发者接入失败时，先把问题归到一个层级，再去对应页面处理。不要同时改 Base URL、令牌、模型、SDK 版本和业务参数。

API 接入仍然失败时，提交这些复现信息

API 问题要能复现，才好判断是认证、模型、请求体、SDK、网络还是服务端 Secret。下面信息足够定位，不需要暴露完整密钥。