星海词元
AI Gateway · 智能网关

星海词元 Key 服务台

一键配置到 WorkBuddy 或更多应用 模型列表加载中…
粘贴 Key 生成后，运行脚本即可自动完成配置（Mac 建议用终端运行，见下方教程），全程无需手动编辑文件；全部模型一次性写入。 默认开启思考能力（强度 Max），可在应用内调低。 Key 不离开浏览器，脚本本地生成直接下载；微信/QQ 内打开时脚本经服务器中转（仅用于即时生成，不做持久化存储）。查询/兑换时 Key 经后端校验但不记录明文。
配置教程 详细版 · 约 2 分钟
0先选路：两种配置方式，对号入座
A · WorkBuddy：在顶部「一键配置」卡片的 WorkBuddy 行里，按你的电脑系统选按钮 —— Windows 点「Windows 导入」；Mac 点「复制终端命令（Mac）」（零下载、无需下载文件），或点「Mac 导入」下载脚本后用「终端」运行。
B · 其它 133 款应用（Claude Code、Codex、Cursor、Cline、Cherry Studio、ZCode、TraeCode、Kimi Code CLI、Dify、n8n 等，完整清单见下方「已适配客户端」）：在顶部「一键配置」卡片下方的 「更多应用」区里，点应用名 → 展开该应用的专属按钮。
1粘贴 Key，点「生成配置」
在上方输入框粘贴 sk- 开头的 Key（Windows Ctrl+V / Mac ⌘V），点 生成配置。下方出现绿色成功提示即完成。
注意：兑换码只是充值凭证、不是 API Key，粘兑换码会一直报 401 Invalid token（本页会在生成前拦截并提示）。
2找到你要配置的应用，点它那一行的导入按钮
按钮按电脑系统分：Windows 电脑点该行的「Windows 导入」；Mac 电脑点「复制终端命令（Mac）」（零下载，推荐），或点「Mac 导入」下载脚本文件。
每个应用名后会标注类型，含义是：自动写入 = 脚本直接写该应用的配置文件（合并模式，不会动你已有的配置项）；参数指引 = 该应用受协议或界面限制无法脚本写入，点开后复制参数，在应用内粘贴即可（例如 Cursor 需在 Models 面板逐个添加模型）。
没找到你的应用？点「更多应用」后逐个点开看。
3运行：Windows 双击，Mac 优选终端粘贴
Windows：双击下载的 .bat 脚本，弹出「已保护你的电脑」时点 更多信息 → 仍要运行。
Mac（推荐，一步到位，零下载）：点您所用应用那一行的「复制终端命令（Mac）」，然后打开「终端」App（⌘Space 搜索"终端"），直接在终端窗口 ⌘V 粘贴，按回车。看到 Import complete! 即完成，全程不需要下载任何文件。
Mac（备选，已下载脚本文件）：打开「终端」App（⌘Space 搜索"终端"），输入 bash ——注意 bash 后面有一个空格——然后把下载的脚本文件直接拖进终端窗口（拖入后自动补全文件路径），按回车即可。此方法可避免 macOS 的 Gatekeeper 提示，适用于所有 .command 脚本。（若双击提示「没有正确的访问权限」或「无法验证开发者」，一律改用此终端方法）。
4确认 Import complete 后关闭
窗口显示 Import complete! 即写入成功，旧配置已自动备份（文件名带时间戳，如 models.json.bak.20260903120000，多次导入不会互相覆盖）。Windows 按任意键、Mac 按回车关闭窗口。
5完全退出对应应用，重新打开后开始使用
必须完全退出（Windows 含右下角托盘图标；Mac 用 ⌘Q）再重新打开，配置才会生效。
各应用选模型的位置：
· WorkBuddy：设置里「自定义模型」中选择；
· ZCode：顶部模型选择器展开 starsea 供应商后选择模型；
· TraeCode CLI：输入 /model，选带「starsea · 」前缀的模型；
· Claude Code / Codex / Qwen Code / OpenCode 等 CLI：按其文档切换 provider（脚本已写好配置项，多数重启即生效）；
· Cherry Studio / Chatbox / NextChat / LobeChat / Open WebUI：在「模型服务 / 提供商」里选择本站条目（参数指引类需手工粘贴刚才复制的参数）；
· Dify / n8n / Coze 等平台：在模型供应商配置页粘贴参数，或按指引新建 OpenAI 兼容供应商，Base URL 填 https://starseaapi.com/v1。
已适配客户端（共 133 款 + WorkBuddy · 均在「更多应用」内）
编程 CLI / 编辑器代理
Claude Code · OpenCode · Kilo Code · MiMo Code · Gemini CLI · Factory Droid · Pi · OpenClaw · CodeBuddy · Qwen Code · Codex · Cline · Continue · Hermes Agent · DeepSeek Harness · Hello Minds · ZCode · Kimi Code CLI · Qoder CLI · Cursor · Aider · Goose · Crush · Zed · Roo Code · Devin Desktop · 通义灵码 · TraeCode · TraeCode CLI · TraeCode Plugin · OpenHands · iFlow CLI · Amp · Amazon Q Developer · CodeFuse · CodeGeeX · Cursor CLI · Fabric · Google Jules · gptme · Open Interpreter · Qodo · ShellGPT · Tabnine · Warp · 文心快码 Comate · mods
桌面 / 聊天客户端
Cherry Studio · Chatbox · NextChat · LobeChat · Open WebUI · Jan · AnythingLLM · LibreChat · SillyTavern · AutoClaw · TraeWork · MiMo Desktop · Msty · ChatWise · TypingMind · BoltAI · OpenCat · 腾讯元宝 · ima 知识库 · 豆包 PC · 智谱清言 · Kimi 桌面 · MiniMax 海螺 · 百川智能 · Qwen Chat · 天工 AI · 纳米 AI · 秘塔 AI 搜索 · 讯飞星火
平台 / 工作流
Dify · n8n · Coze · FastGPT · bolt.diy · RAGFlow · MaxKB · Langflow · Flowise · LangChain · LangGraph · AutoGen · CrewAI · LlamaIndex · LiteLLM · PydanticAI · Agno · Semantic Kernel · AgentScope · AutoGPT · Botpress · Browser Use · Camel-AI · DeerFlow · DSPy · Google ADK · Haystack · Helicone · Khoj · Langfuse · Letta · Mastra · MetaGPT · Microsoft Agent Framework · OpenAI Agents SDK · Playwright MCP · Portkey · Qwen-Agent · Rasa · Skyvern · Stagehand · Vercel AI SDK · smolagents · 腾讯元器
浏览器扩展 / 其它
沉浸式翻译
编辑器 / IDE 插件
GitHub Copilot · JetBrains AI · Sourcegraph Cody · Tabby · avante.nvim · Void · PearAI · Theia IDE · codecompanion.nvim · gptel · aidermacs · Obsidian Copilot
官方客户端（本页顶部「一键配置」）
WorkBuddy
Mac 用户快捷配置入口
① 粘贴 Key → 点「生成配置」→ 点第二个按钮「复制终端命令（Mac）」；② 打开「终端」App（⌘Space 搜索"终端"）→ ⌘V 粘贴 → 回车；③ 看到 Import complete! 和 [自检] ... OK 即成功 → 完全退出 WorkBuddy（⌘Q）后重开。全程零下载、零拦截、零权限。ZCode 用户同理，在其面板点「复制终端命令（Mac）」。
双击后窗口一闪而过？
多为下载未完成就双击，或文件被浏览器改名。重新点击下方对应系统的导入按钮，等下载完成后再到保存位置运行。成功标志是黑色窗口停在「请按任意键继续」。
电脑装了 360 / 电脑管家，提示有风险或文件被删除？
这是安全软件对 .bat 脚本的常规提示（本脚本为纯文本写入，无任何危险操作，且已内置旧配置备份）。处理方式任选：① 弹窗时选择「允许运行 / 信任本文件」；② 若文件被自动清除，先暂停 360 防护 5 分钟，重新下载并运行，完成后再开启；③ 不想动安全软件，可点本页「复制配置」，按下方手动方式粘贴到 models.json。导入完成后即可恢复全部防护。
Windows 提示「已保护你的电脑」怎么办？
这是系统对未知发布者脚本的常规提示。点弹窗上的 更多信息 → 仍要运行。脚本仅将配置写入您本机的 models.json，断网也可运行。
重启后看不到我们的模型？
① 确认脚本窗口显示 Import complete 而非 ERROR；② 确认 WorkBuddy 已完全退出（含托盘）后重开；③ 在模型列表底部点「配置自定义模型」确认列表加载。仍不行可点本页「重新生成」再试。
不想用脚本，手动配置可以吗？
可以。点本页 复制配置，手动新建 ~/.workbuddy/models.json（Windows 为 C:\Users\您的用户名\.workbuddy\models.json）粘贴保存，重启 WorkBuddy 即可。建议先备份原文件。ZCode 手动配置：编辑 ~/.zcode/v2/config.json，在 provider 对象内新增 starsea 条目（JSON 结构可参考代码块中 "_zcode_starsea_snippet" 字段，去掉该字段其余照抄）。
Mac 双击提示「无法打开，因为无法验证开发者」？
这是 macOS Gatekeeper 对未签名脚本的常规拦截。推荐改用终端运行（见教程第 3 步）：打开「终端」，输入 bash （bash 后有一个空格），把 install-models-mac.command 拖进终端窗口按回车，一步完成，不受该提示影响。若仍想双击：右键点击文件 → 打开 → 打开（仅首次需要）；或打开 系统设置 → 隐私与安全性，拉到底部找到关于该文件的提示，点 仍要打开。
Mac 双击提示「没有正确的访问权限」？
浏览器下载的脚本丢失了可执行权限，macOS 因此拒绝执行（右键打开也无效）。推荐直接用终端运行：打开「终端」应用，输入 bash （注意 bash 后有一个空格），把 install-models-mac.command 文件拖进终端窗口，按回车即可。bash 方式不需要可执行权限，无需任何额外设置。也可以先授予权限再双击：终端执行 chmod +x 后把文件拖进终端按回车，之后即可正常双击。
Mac 终端提示 Permission denied？
这是双击方式缺少可执行权限的提示，终端 bash 拖入方式不会遇到。如果直接执行 ./install-models-mac.command 遇到 Permission denied：打开「终端」，输入 bash （bash 后有一个空格），把文件拖进终端窗口按回车即可（bash 解释执行不要求可执行权限）。
我还没有 API Key，怎么创建？（兑换码不能当 Key 用）
兑换码只是充值凭证，不是 API Key。把兑换码粘贴进上面的 Key 输入框，导入后客户端会一直报 401 Invalid token——本页现在会在生成前拦截并提示。
创建 API Key 只需 4 步：
① 打开 starseaapi.com 并登录您的账号（还没有账号请先注册）；
② 进入左侧「令牌」页（英文界面为 Tokens / API Keys）；
③ 点「添加令牌」，名称随意填（如 my-key），其余保持默认，点「提交」；
④ 在列表里点该令牌的「复制」按钮，复制到以 sk- 开头的一长串，就是您的 API Key。
拿到后回到本页粘贴、点「生成配置」即可。用兑换码充值的余额会显示在该 Key 下；若某个令牌显示「已禁用 / 已过期」，新建一个即可。
Key 报错（401 / 余额不足 / 已禁用）？
401 Invalid token 表示客户端发送的 Key 在服务器上不存在——最常见原因是把兑换码当成了 Key（见上一条），其次是复制不完整、或该令牌已被删除。请到「查询充值」tab 粘贴 Key：查不到即为无效，请按上一条重建。
其余情况：余额不足可通过购买渠道续费，或用兑换码充值（查询后本页出现充值入口）；已禁用多为违反使用条款（转售/共享），可联系客服核实。该说明同时适用于 WorkBuddy / ZCode / TraeCode。
同一个 Key 昨天还能用，今天突然报 401 Invalid token？
这通常不是您的配置变了，而是手上的这个 API Key（卡密）已被平台停用或更换——常见于客服已为您换发新 Key、旧卡密作废，或该卡密的额度已结算完毕。
① 自查：点上方「Key 自检」按钮；若提示「不存在或已被删除」，即可确认是这种情况。
② 解决：通过您的购买渠道联系客服，索取换发后的新 API Key。（在 starseaapi.com 控制台「令牌」页自己创建的 Key 不会被平台回收，长期使用推荐自己创建。）
③ 换新后：回到本页粘贴新 Key → 点「生成配置」→ 重新导入客户端（WorkBuddy 需完全退出后重开）即可恢复。
报错「无可用渠道 / No available channel / 模型不可用」？
这说明客户端请求的模型名在本站没有在售渠道。绝大多数情况是——您用的那个模型已经下架了（例如 gpt-*、claude-*、gemini-*、grok-* 系列，以及 hy4-preview、tc-code-latest 等历史型号），而客户端的模型列表还是旧配置。
① 自查：到本页「模型价格」tab 搜索该模型名，搜不到即为已下架。
② 解决：回到「一键导入」tab，重新粘贴 Key → 点「生成配置」→ 按提示重新导入客户端（脚本会自动剔除已下架模型）；或手动把客户端里那条模型删掉，换成「模型价格」中在售的模型。
③ 常见笔误：模型名大小写敏感（Glm-5.3-flash ≠ glm-5.3-flash）；带 / 前缀的原始 ID（如 deepseek/deepseek-v4-pro-0813）不在本站清单内。请一律以「模型价格」页显示的名称为准。
报错 429 / 用量上限 / 速率限制（Rate limit）？
429 表示请求被服务端限流，不是本站故障，也不会产生扣费，常见两种，处理方式不同：
① 用量窗口用尽（最常见）：原文形如 You have exceeded the 5-hour usage quota / weekly usage quota，意思是您这张卡密对应的套餐已把「5 小时额度」或「每周额度」用完，到原文提示的时间点会自动恢复（5 小时额度按滚动窗口恢复，周额度按下周重置），无需任何操作。
② 速率 / 并发超限：原文形如 Token capacity exceeded、The request rate exceeds the current model TPM limit，意思是单位时间内的 token 量或请求数过多——常见于同一个 Key 被多台设备或多人同时使用、客户端并发/重试调得太高。降低并发、等几秒重试通常即可。
③ 建议：先用上方「Key 自检」确认 Key 本身正常；若频繁撞上限，说明当前套餐规格不够，请联系客服升级套餐或换用更高档卡密。
接口地址到底填哪个？（base_url 还是完整 URL）
两者不同，填错会报 404（例如 /v1/chat/completions/control、/v1/v1/models 这种重复路径）。
① base_url（只到 /v1）：https://starseaapi.com/v1
适用于绝大多数客户端：ZCode、TraeCode CLI、Claude Code、Cherry Studio、NextChat、LobeChat、Open WebUI、各类 SDK（OpenAI/Anthropic 兼容）。客户端会自己在后面拼 /chat/completions。
② 完整 URL（含端点）：https://starseaapi.com/v1/chat/completions
适用于个别要求「完整请求地址」的客户端；本页一键导入脚本已统一写入 base_url（只到 /v1），客户端会自动补全端点路径。
判断方法：如果报 404 且路径里出现两遍 chat/completions 或两遍 v1，说明您把「完整 URL」填进了「base_url」的位置，改回只到 /v1 即可。
发图片能用吗？本站全部模型都支持识图（免费）
本站全部在售模型都支持图片输入，不需要任何额外配置，也不额外收费（本站免费福利）。分两种情况：
① 原生多模态模型（如 qwen 系等）：图片由模型原生处理，体验一致。
② 纯文本模型（如 deepseek-v4-flash、glm-5.3、hy3、longcat-2.0 等）：网关会先自动为您的图片生成一份结构化描述（主色、文字逐字转录、表格 / 图表内容、界面元素），再把描述交给模型 —— 所以这些模型也能「看懂」图片。
③ 已支持：图片内容理解、OCR 文字提取、表格与图表读取、代码 / JSON 截图识别；截图、照片、图表、表格、UI 界面都可以直接发。
④ 为什么更快：同一张图片全站只解析一次并复用结果，重复使用同一张图时响应明显更快，且不产生额外计费。
⑤ 若仍报错：把模型名反馈给客服即可，我们会在 24 小时内补齐；各模型能力也可在「模型价格」tab 查看。
怎么用本站的「生图」模型出图？
本站生图模型当前暂不可用，一键导入脚本会在恢复后自动重新包含（以本页「模型价格」tab 实时在售为准）。
① 用法：在客户端把模型切换到可用的生图模型（以本页「模型价格」tab 的「图像生成」分类为准），然后直接用自然语言描述您想要的画面（例如「白色背景上一个红色圆形，扁平插画风格，1024×1024」），模型就会返回一张图片。建议在描述里写清画面内容、风格、尺寸/比例，效果更稳。
② 注意：返回的是一段图片链接（有效期约 24 小时），请及时另存/转发到自己的图床或相册；链接过期后重新生成一次即可。
③ 计费与选型：按次计费，各档规格不同，详见「模型价格」tab 顶部分类筛选中的「图像生成」。
同样的内容怎么更省钱、更快？（前缀缓存）
服务端会把每次请求开头完全相同的那一段缓存下来。重复的部分按缓存命中价计费，低至输入价的 2%（各模型比例不同：DeepSeek 系列为输入价的 1/50、豆包系列约 1/5、GLM-5.3-Flash 约 1/3.5）；长文档、长代码场景下命中还能明显缩短等待时间。
① 固定内容放最前面：系统提示词、工具/函数定义、长文档、固定示例，都放在请求最前面；会变的内容放最后（本次问题、时间戳、随机 ID）。
② 同一段固定内容复用同一个请求头：若客户端支持，给同一会话固定传同一个 X-Session-Id（或 prompt_cache_key）值。这样同一段前缀的请求会被固定送到同一条线路，缓存才能持续命中。
③ 千万不要把时间戳、当天日期、随机 ID、每次都在变的动态清单写进 system prompt —— 只要改了其中一个字符，整段缓存立刻失效，这类内容之后的部分都要按原价重算。
注意：缓存按「块」对齐（约 64 token 一块），所以固定前缀至少要有几百 token 才有收益；太短的前缀不会被缓存。
举例：一次 10 万 token 的请求，若其中 9 万 token 命中缓存（以 DeepSeek 系列口径），输入部分大约只花全额计费的 1/8 左右。
想恢复原来的配置？
脚本导入前已将旧配置自动备份（文件名带时间戳，如 models.json.bak.20260903120000，每次导入生成新备份，不会覆盖）。恢复时：删除当前 models.json，将想恢复的时间戳备份改名为 models.json，重启 WorkBuddy。
ZCode 导入会覆盖我已有的模型配置吗？
不会。ZCode 导入为合并模式：脚本只新增（或更新）名为 starsea 的供应商，您已有的 GLM 登录、Claude、OpenAI 等其他供应商配置原样保留。导入前同样自动备份 config.json.bak.时间戳。若之前导入过本站模型，会直接更新到最新模型列表。
ZCode 导入后模型列表在哪里看？
完全退出 ZCode 后重新打开，点主界面顶部的模型选择器，展开 starsea 供应商即可看到全部模型。也可在 Settings → Model providers 中确认供应商已启用（导入脚本默认已置为启用）。
ZCode 导入报错 "not valid JSON" 或没反应？
① 确认脚本窗口显示 Import complete!；② 若提示 PowerShell 被禁用（极少数企业电脑），可点本页「复制配置」后手动编辑 ~/.zcode/v2/config.json，在 provider 对象内粘贴 starsea 段落；③ ZCode 首次使用需先在界面内完成过任意一次模型配置（生成过 config.json）再运行脚本。
TraeCode（桌面 IDE）为什么没有一键脚本？
TraeCode的自定义模型保存在其内部数据库中（官方未提供配置文件导入接口）。第三方脚本直接改写该数据库有损坏配置、导致 TraeCode 无法启动的风险，因此桌面版采用「配置向导」方式：向导会为您复制好 Key 与接口地址，并给出推荐模型清单，您只需在 TraeCode 的图形界面里逐个粘贴添加（每个模型约 10 秒）。TraeCode CLI（命令行版）有官方文档化的配置文件，因此支持完整一键脚本导入。
TraeCode CLI 脚本会覆盖我已有的模型吗？
不会。TraeCode CLI 导入为合并模式：脚本只新增/更新名称以「starsea · 」为前缀的模型条目（这些条目全部来自本站），您手工添加的模型、默认模型设置等其余配置原样保留。导入前自动备份 trae_cli.yaml.bak.时间戳；重复运行脚本会先把本站上一批条目整体移除再写入最新列表，不会残留重复项。
TraeCode CLI 导入后如何确认生效？
完全退出 TraeCode CLI 后重新打开，输入 /model 并按两次回车打开模型列表，即可看到全部带「starsea · 」前缀的模型（如 starsea · glm-5.3），选择任意一个发起对话即表示配置成功。也可运行 traecli config edit 直接查看配置文件内容。