快速开始 三步开始使用 ① 登录控制台,在「API 密钥」创建专用密钥,确认分组、余额与模型权限。② 从「模型广场」复制模型 ID,区分大小写和标点;渠道名称不是模型 ID。③ 在工具中选择 OpenAI Compatible,填写下方地址、密钥和模型,先发送“只回复 OK”,再测试多轮和工具调用。
本文覆盖常见工具及通用接入方式,不等于所有客户端或所有模型均完成实测。各客户端菜单可能随版本调整。核对日期:2026-09-15。
复制 API Base URL:https://stardustkey.zzhyht.top/v1
API Host(客户端自动添加 /v1 时):https://stardustkey.zzhyht.top
API Key:你在本站创建的密钥
Model ID:从模型广场复制
完整聊天地址:https://stardustkey.zzhyht.top/v1/chat/completions必读 地址与协议怎么选 Base URL 通常填到 /v1,不要填完整 /chat/completions,也不要出现 /v1/v1。若工具另有 API Path 字段,Host 填域名,Path 填 /v1/chat/completions。
Chat Completions、Responses 与 Anthropic Messages 是不同协议。模型能聊天,不表示一定支持 Responses、图片、联网、工具或 JSON Schema。Codex 和 Claude Code 请先按对应章节确认协议;本页未逐模型验收这些能力。
模型列表以当前密钥调用 /v1/models 的结果为准。不同分组可能看见不同模型。
聊天客户端 Cherry Studio 进入设置 → 模型服务,新增 OpenAI 类型服务商,名称填写 Stardust API。填入本站 API Key。常规地址填域名,检查客户端预览的实际请求路径是否为 /v1/chat/completions。获取模型或手动添加模型 ID,启用后在助手中选择。
遇到 404,先核对客户端自动拼接路径;不要把完整聊天 URL 与自动补全规则混用。首次仅测试文本对话,图片与工具按模型能力开启。
复制 https://stardustkey.zzhyht.top官方配置参考 ↗ 聊天客户端 Chatbox 设置 → 模型提供方 → 添加自定义提供方,选择 OpenAI API 类型。API Host 填本站域名;若版本提供 API Path,填写 /v1/chat/completions。输入 API Key 并添加模型 ID,保存后在对话中切换该模型。
不要选 Chatbox 自带订阅作为本站密钥的入口。连接失败时,检查实际 URL 是否重复 /v1。
复制 https://stardustkey.zzhyht.top官方配置参考 ↗ 聊天客户端 Open WebUI 由管理员打开设置中的 Connections(连接),添加 OpenAI-compatible 连接,填入 /v1 地址及 API Key。保存后刷新模型列表,按需配置用户可见权限。若模型列表为空,先用下面的 API 示例验证密钥。
服务端连接要求部署 Open WebUI 的机器能访问本站;浏览器 Direct Connections 则还受 CORS 限制。模型连接不是 OpenAPI 工具服务器,勿填到工具服务器列表。
复制 https://stardustkey.zzhyht.top/v1官方配置参考 ↗ 编程工具 Cline 打开 Cline 设置 → API Provider 选择 OpenAI Compatible。Base URL 填 /v1 地址,API Key 填本站密钥,Model ID 填模型广场中的完整 ID。上下文长度、图片和工具能力按实际模型设置,不要虚填。
先让它读取一个测试文件,确认出现可执行的工具调用;正文里写着“调用工具”不代表工具真的执行。Plan / Act 如各有配置,需要分别设置。
复制 https://stardustkey.zzhyht.top/v1官方配置参考 ↗ 编程工具 Continue 打开 Continue 的本地模型配置,把下例合并到 config.yaml;替换 YOUR_MODEL_ID 和密钥占位符。保存后选择 Stardust 模型测试聊天。Agent 工具支持需另外验证;聊天模型不自动具备补全、嵌入或重排序能力。
复制 name: Stardust Local
version: 1.0.0
schema: v1
models:
- name: Stardust
provider: openai
model: YOUR_MODEL_ID
apiBase: https://stardustkey.zzhyht.top/v1
apiKey: YOUR_API_KEY
roles:
- chat官方配置参考 ↗ 编程工具 Aider 按 Aider 官方安装指南安装,在项目目录启动。下面是 Windows PowerShell 当前终端的配置;macOS/Linux 使用 export NAME="value"。模型名必须加 openai/ 前缀。
首次用测试项目检查 diff,再决定是否提交;未知模型可能需要配置上下文和编辑格式。
复制 $env:OPENAI_API_BASE = "https://stardustkey.zzhyht.top/v1"
$env:OPENAI_API_KEY = "YOUR_API_KEY"
aider --model openai/YOUR_MODEL_ID官方配置参考 ↗ 编程工具 · 条件接入 Codex CLI 前提:选择的渠道和模型支持 Responses API,不能仅凭 Chat Completions 测试成功判断。将配置合并到 ~/.codex/config.toml(Windows 为用户目录下 .codex/config.toml),避免覆盖已有设置。先设置 STARDUST_API_KEY 环境变量,再从同一终端启动 codex。
模型 ID 替换为本站实际可用且适配 Codex 的模型。本页提供配置模板,未完成该客户端的完整 Agent 验收。
复制 model = "YOUR_MODEL_ID"
model_provider = "stardust"
[model_providers.stardust]
name = "Stardust API"
base_url = "https://stardustkey.zzhyht.top/v1"
env_key = "STARDUST_API_KEY"
wire_api = "responses"
# PowerShell 中另行执行:
# $env:STARDUST_API_KEY = "YOUR_API_KEY"
# codex官方配置参考 ↗ 编程工具 · 条件接入 Claude Code 前提:渠道支持 Anthropic Messages 协议及 Claude Code 所需工具语义。只支持 OpenAI Chat Completions 的模型不能直接套用。以下为 PowerShell 会话配置,在同一终端启动;Base URL 不加 /v1/messages。
YOUR_MODEL_ID 需替换为管理员确认兼容的模型。先进行短对话及只读工具测试;不承诺所有本站模型兼容 Claude Code。
复制 $env:ANTHROPIC_BASE_URL = "https://stardustkey.zzhyht.top"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
claude --model YOUR_MODEL_ID官方配置参考 ↗ 编程工具 · 版本限制 Cursor / Windsurf IDE Cursor:进入 Models / API Keys 设置;如果当前版本提供 Override OpenAI Base URL,填本站 /v1 地址及密钥,再添加模型 ID 并验证。若没有自定义地址入口,不要把本站密钥填进官方服务商地址。
Windsurf IDE:先确认当前版本与套餐是否支持自定义 OpenAI-compatible 地址;仅有官方供应商 BYOK 不等于支持任意网关。本站存在 Windsurf 上游渠道,也不等于 Windsurf IDE 一定能直接用。
这两项需以当前产品支持范围为准,本页不承诺补全、Tab 或所有 Agent 功能走自定义密钥。
官方配置参考 ↗ 编程工具 OpenCode 在 OpenCode 配置文件中添加自定义 provider,使用 @ai-sdk/openai-compatible,指定本站 baseURL;密钥从环境变量读取。模型列表中的键和 model 选择器须对应。按官方 /connect 流程或环境变量完成鉴权,之后用 /models 选择模型。
复制 {
"$schema": "https://opencode.ai/config.json",
"provider": {
"stardust": {
"npm": "@ai-sdk/openai-compatible",
"name": "Stardust API",
"options": {
"baseURL": "https://stardustkey.zzhyht.top/v1",
"apiKey": "{env:STARDUST_API_KEY}"
},
"models": {
"YOUR_MODEL_ID": {
"name": "Stardust Model"
}
}
}
},
"model": "stardust/YOUR_MODEL_ID"
}官方配置参考 ↗ Agent · 条件接入 OpenClaw 在 OpenClaw 配置中合并自定义 models.providers,设置 baseUrl、apiKey 与 openai-completions 类型,模型引用采用 stardust/模型ID。具体字段以当前版本文档为准。
聊天可用后再测试工具、图片、长会话与消息渠道;本站密钥负责模型请求,微信/QQ 等消息渠道仍须在 OpenClaw 单独配置。不要因 API 接通就直接开放所有工具权限。
复制 {
"models": {
"providers": {
"stardust": {
"baseUrl": "https://stardustkey.zzhyht.top/v1",
"apiKey": "${STARDUST_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "YOUR_MODEL_ID",
"name": "Stardust Model"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "stardust/YOUR_MODEL_ID"
}
}
}
}官方配置参考 ↗ 工作流 Dify 工作区设置 → 模型供应商,安装并配置支持 OpenAI-compatible 的供应商插件。填写 API endpoint(本站 /v1)、API Key 和模型 ID。保存后在应用 LLM 节点选择该模型,运行预览,再发布应用。
插件字段可能不同:以实际请求到 /v1/chat/completions 为准。知识库还需要单独的 Embedding 模型,不要把聊天模型配置成嵌入模型。
复制 https://stardustkey.zzhyht.top/v1官方配置参考 ↗ 工作流 n8n 新建 OpenAI 凭据,填 API Key 与 Base URL;在 OpenAI Chat Model 或对应节点选择模型 ID。若节点要求 Responses,先确认渠道支持;不兼容时可用 HTTP Request 调用 Chat Completions。
HTTP Request:POST 完整聊天地址,使用凭据保存 Bearer Token,Body 选择 JSON,填 model 与 messages。先用手动执行检查输出,不要把 Key 写到公开工作流字段里。
复制 https://stardustkey.zzhyht.top/v1官方配置参考 ↗ 开发集成 LiteLLM 安装 litellm 后选择 openai/模型ID,指定 api_base 和 api_key。可用于自己的后端统一调用;密钥从环境变量加载。额外重试可能增加请求次数,先从单次调用验证。
复制 import os
from litellm import completion
r = completion(
model="openai/" + os.environ["STARDUST_MODEL"],
api_base="https://stardustkey.zzhyht.top/v1",
api_key=os.environ["STARDUST_API_KEY"],
messages=[{"role": "user", "content": "只回复 OK"}],
)
print(r.choices[0].message.content)官方配置参考 ↗ 开发集成 Python SDK 安装:python -m pip install openai。先设置 STARDUST_API_KEY 与 STARDUST_MODEL,再运行。示例使用 Chat Completions;不把上游 reasoning 当作最终 content。请求超时和权限问题参考排错章节。
复制 import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["STARDUST_API_KEY"],
base_url="https://stardustkey.zzhyht.top/v1")
r = client.chat.completions.create(
model=os.environ["STARDUST_MODEL"],
messages=[{"role": "user", "content": "只回复 OK"}],
)
print(r.choices[0].message.content)
print("结束原因:", r.choices[0].finish_reason)官方配置参考 ↗ 开发集成 Node.js SDK 安装:npm install openai。保存为 example.mjs,设置 STARDUST_API_KEY 和 STARDUST_MODEL 后运行 node example.mjs。代码仅在服务端运行,不把密钥打包进网页或小程序。
复制 import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.STARDUST_API_KEY,
baseURL: "https://stardustkey.zzhyht.top/v1",
});
const result = await client.chat.completions.create({
model: process.env.STARDUST_MODEL,
messages: [{ role: "user", content: "只回复 OK" }],
});
console.log(result.choices[0].message.content);官方配置参考 ↗ API 基础 cURL / PowerShell / Postman PowerShell 示例先列出当前密钥可用模型,再发起聊天。把占位符替换为自己的值。Postman / Apifox 同理:POST 完整聊天地址,Authorization 选 Bearer Token,Body 选 JSON。
macOS/Linux 的 cURL 可使用下方同样的 URL、Authorization 请求头与 JSON Body。不要把本机终端的命令行别名 curl 当作 curl.exe。
复制 $env:STARDUST_API_KEY = "YOUR_API_KEY"
$headers = @{ Authorization = "Bearer $env:STARDUST_API_KEY" }
Invoke-RestMethod "https://stardustkey.zzhyht.top/v1/models" -Headers $headers
$body = @{
model = "YOUR_MODEL_ID"
messages = @(@{ role = "user"; content = "只回复 OK" })
} | ConvertTo-Json -Depth 10
Invoke-RestMethod "https://stardustkey.zzhyht.top/v1/chat/completions" `
-Method Post -Headers $headers -ContentType "application/json; charset=utf-8" `
-Body ([Text.Encoding]::UTF8.GetBytes($body))API 基础 cURL 命令示例 macOS / Linux 示例。请先 export STARDUST_API_KEY="你的密钥";替换请求中的 YOUR_MODEL_ID。Windows 可使用上一节 PowerShell 版本。
复制 curl "https://stardustkey.zzhyht.top/v1/chat/completions" \
-H "Authorization: Bearer $STARDUST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"只回复 OK"}]}' 通用接入 其他兼容客户端 Roo Code、Kilo Code、LobeChat、NextChat、LibreChat、SillyTavern、LobeHub 及其他客户端:先确认安装版本提供 Custom / OpenAI Compatible 入口,再按「域名或 /v1 地址 + Key + 模型 ID」配置。它们的版本字段和默认路径不同,本页不提供未经核对的专属配置文件。
如只能填写官方 Key、不能改服务器地址,则不能据此判断支持本站。ChatGPT 官方网页或 App 也不是填写第三方 Base URL 的通用客户端。
接入 MCP 工具与接入模型 API 是两件事;本站模型 Key 不能直接当作 MCP 服务器地址或鉴权。
使用指南 接通后如何验收 ① 短回复:发送“只回复 OK”,核对正文是否准确。② 多轮:先告诉模型一个随机值,下一轮只询问之前的值,不要在问题中重复答案。③ 工具:确认返回 tool_calls,function.arguments 是合法 JSON 字符串,执行后用匹配的 tool_call_id 回传结果。④ 断线:保存完整 messages,重放后核对任务与工具结果。
Chat Completions 的 chatcmpl-* 是响应 ID,不是保证可恢复的会话句柄。不要把它随意填入 previous_response_id。正文包含目标词也不等于严格格式通过。
模型是否支持图片、工具、结构化输出,以对应入口与模型的实测为准。
排错 常见问题与排查 401:Key 无效、缺少 Bearer、使用了其他平台的密钥。403:分组、模型权限或访问限制不匹配。404:检查 /v1 是否重复及协议是否正确。429:检查限流与额度,按提示退避重试。500/502/503:保留时间、模型、请求 ID 与完整错误,联系管理员;不要无限重试。
模型列表为空:确认密钥分组、模型限制及余额;尝试手动添加已获授权的准确 ID。网页返回 HTML:可能请求到了主页而不是 API 路径。
回复被截断:检查 finish_reason=length 与 completion_tokens,思考模型需要为推理和最终答案留足预算;不要用 48/64 tokens 验收长答案。提高额度会增加潜在消耗。
工具写在正文:确认 tools、tool_choice 和模型支持,只有标准工具结果才应执行。
断流:客户端持久化历史;避免重复执行已产生副作用的工具。提交故障时隐藏密钥,提供脱敏请求、完整响应、客户端版本与发生时间。
使用指南 额度、密钥与能力说明 本站密钥与 OpenAI、Anthropic 或客户端订阅账号相互独立。可用模型、价格、分组与额度以控制台实时显示为准;对外模型 ID 可能是渠道别名,能力以本站说明和实际调用结果为准。
给不同工具创建独立 Key,配置合理额度;遗失或泄露后撤销重建。不要向公共截图、Git 仓库或前端代码提交 Key。
本页示例没有真实密钥;没有宣称所有工具已完成端到端验证。文档随客户端和本站能力变化更新。
没有找到相关内容,请更换关键词。