快速开始

三步开始使用

① 登录控制台,在「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。 本页示例没有真实密钥;没有宣称所有工具已完成端到端验证。文档随客户端和本站能力变化更新。