API 与 SDK 接入

更新于 2026-09-20 · 页面与服务规则以当前控制台为准

选择协议与模型

OpenAI 兼容基础地址为 https://musecz.xyz/v1。不同模型可能只支持部分接口，先确认 Chat Completions、Responses 或 Anthropic Messages 的兼容范围。

先用 最小 cURL 请求验证 Key、模型和地址，再接入项目。生产 Key 放服务端环境变量，不写进浏览器前端。

Node.js：OpenAI SDK

sh

npm install openai

以下使用 Chat Completions；环境变量 暮色api_MODEL 填当前可用模型 ID。

javascript

import OpenAI from 'openai';

const client = new OpenAI({
apiKey: process.env.MUSECZ_KEY,
baseURL: 'https://musecz.xyz/v1'
});

const result = await client.chat.completions.create({
model: process.env.暮色api_MODEL,
messages: [{ role: 'user', content: '请只回复 OK' }]
});
console.log(result.choices[0].message.content);

Python：OpenAI SDK

sh

python -m pip install openai

python

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.environ['MUSECZ_KEY'],
  base_url='https://musecz.xyz/v1',
)
result = client.chat.completions.create(
  model=os.environ['暮色api_MODEL'],
  messages=[{'role': 'user', 'content': '请只回复 OK'}],
)
print(result.choices[0].message.content)

Responses 接口

对于支持 Responses 的模型，可以使用 SDK 的对应接口：

javascript

const result = await client.responses.create({
model: process.env.暮色api_MODEL,
input: '请只回复 OK'
});
console.log(result.output_text);

Codex 的客户端配置见 Codex CLI。不要为一个不支持的模型强行切换协议。

Anthropic 兼容工具

使用基础地址 https://musecz.xyz，API Key 仍由本站创建。客户端按 Anthropic 方式配置，不手工重复拼 /v1，详见 Claude Code。

API 接入补充

除 Chat Completions 与 Responses 外，本站兼容 OpenAI、Anthropic 等主流协议。请先确认目标模型支持的协议，再按对应接口调用，不要强制用单一协议套用所有模型。

上线前检查

• 使用独立 Key 和预算，确认分组权限。
• 处理连接、读取与业务超时；长任务先查询状态，避免重复提交。
• 对临时 429／5xx 使用有上限的退避重试；认证或参数错误不要盲重试。
• 记录时间、模型、request id／task id 和错误正文，日志中不保存完整 Key。
• 实际费用以本站使用日志和计费规则为准。