接入指南
在 Seedrise 上使用 OpenCode
OpenCode 通过 opencode.json 里的自定义 provider 接入 Seedrise:使用 @ai-sdk/openai-compatible 包、Base URL 设为 https://api.seedrise.ai/v1,即可调用你 Key 上的全部模型;Claude 也可以走 OpenCode 内置的 Anthropic provider,指向同一个 URL。
更新于 2026-11-02
OpenCode 配置一览
已于 2026 年 11 月 2 日对照 OpenCode 的 provider 与配置文档核对。
| 配置项 | 取值 |
|---|---|
| Provider ID | seedrise。ID 可以自定,但必须与 /connect 中使用的 ID 一致。 |
| npm 包 | @ai-sdk/openai-compatible,调用 /v1/chat/completions |
| options.baseURL | https://api.seedrise.ai/v1 |
| options.apiKey | {env:SEEDRISE_API_KEY},或用 /connect 保存 Key |
| 模型 ID | 厂商自己的模型 ID,不带厂商前缀,例如 deepseek-v4-pro |
| Claude(可选) | 内置的 anthropic provider,baseURL 设为 https://api.seedrise.ai/v1 |
| 不支持 | @ai-sdk/openai:OpenCode 用它调用 Responses API(/v1/responses),Seedrise 暂不支持。 |
为什么让 OpenCode 走 Seedrise
一个 provider,接入全部模型
GPT、DeepSeek、Kimi、Qwen 和 Claude 共用一个 Base URL、一把 Key。用 /models 切换模型,其他都不用改。
按账户报价,一张账单
按账户对照各厂商公开标价报价,每月一张美元或澳元账单。
每把 Key 都可设限
每把 Key 可限制额度、模型、IP 和有效期。标注 AU 的模型,包括 Claude Opus 5.5、Sonnet 5.5 和 Haiku 5.5,可按需固定在悉尼或墨尔本推理。
五分钟接入
- 安装 OpenCode。 按 OpenCode 的安装指南在 macOS、Linux 或 Windows 上安装,这一步与 Seedrise 无关。
- 获取 Seedrise Key。 申请报价单,收到控制台账号后,在控制台为 OpenCode 创建一把 Key,只开通你要用的模型,并设置每月额度。
- 把 Key 放进环境变量。 写进 shell 配置文件(
~/.zshrc或~/.bashrc)。配置通过{env:SEEDRISE_API_KEY}读取,Key 不会落在可能被提交的文件里。bashexport SEEDRISE_API_KEY="sk-..." # your Seedrise key - 在 opencode.json 中添加 Seedrise。 个人使用写
~/.config/opencode/opencode.json;想随仓库共享,就写项目根目录的opencode.json。模型 ID 不带厂商前缀。opencode.json{ "$schema": "https://opencode.ai/config.json", "provider": { "seedrise": { "npm": "@ai-sdk/openai-compatible", "name": "Seedrise", "options": { "baseURL": "https://api.seedrise.ai/v1", "apiKey": "{env:SEEDRISE_API_KEY}" }, "models": { "gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 1050000, "output": 128000 } }, "deepseek-v4-pro": { "name": "DeepSeek V4 Pro", "limit": { "context": 1000000, "output": 384000 } }, "kimi-k3.1-pro": { "name": "Kimi K3.1 Pro" }, "qwen3.8-max": { "name": "Qwen3.8 Max", "limit": { "context": 1000000, "output": 131072 } } } }, "anthropic": { "options": { "baseURL": "https://api.seedrise.ai/v1", "apiKey": "{env:SEEDRISE_API_KEY}" }, "whitelist": ["claude-opus-5-5", "claude-sonnet-5-5", "claude-haiku-5-5"] } }, "model": "anthropic/claude-sonnet-5-5", "small_model": "anthropic/claude-haiku-5-5" } - 启动并验证。 运行
opencode models seedrise列出配置里的模型,然后启动opencode,用/models选模型,发出第一条提示词。
配置各部分的作用
seedrise使用@ai-sdk/openai-compatible,调用/v1/chat/completions,适用于你 Key 上的所有模型。anthropic保留 OpenCode 内置的 Claude provider 及其模型元数据,只是把请求发到 Seedrise。Base URL 以/v1结尾,因为这个 provider 会自己追加/messages。Claude Code 不同,它用的是根 URL。whitelist把 Claude 列表限定为你 Key 能调用的模型。只有 Key 上开通了claude-fable-5-1,才把它加进去。limit告诉 OpenCode 每个模型的上下文窗口和最大输出,便于显示剩余上下文。此项可选,数值来自模型库。- 想全部走一个 provider?把 Claude 的 ID 加到
seedrise.models下并删掉anthropic段,Claude 就改走 Chat Completions。
本配置中的模型
厂商公开标价,单位为美元 / 每百万 token(输入 / 输出),截至 2026 年 11 月 1 日;上下文窗口核对于 2026 年 11 月 1 日。Seedrise 报价单按账户对照这些价格报价。
| 模型 | 在 OpenCode 中选择 | 上下文 | 厂商公开标价,输入 / 输出 | 区域 |
|---|---|---|---|---|
| Claude Opus 5.5 | anthropic/claude-opus-5-5 | 1M | 4.00 / 20.00 | AU |
| Claude Sonnet 5.5 | anthropic/claude-sonnet-5-5 | 1M | 2.00 / 10.00 | AU |
| Claude Haiku 5.5 | anthropic/claude-haiku-5-5 | 1M | 0.10 / 0.50 | AU |
| GPT-6.1 Sol | seedrise/gpt-6.1-sol | 1.1M | 2.00 / 10.00 | 全球 |
| DeepSeek V4 Pro | seedrise/deepseek-v4-pro | 1M | 1.32 / 3.96 | 全球 |
| Kimi K3.1 Pro | seedrise/kimi-k3.1-pro | 1M | 2.00 / 10.00 | 全球 |
| Qwen3.8 Max | seedrise/qwen3.8-max | 1M | 2.00 / 6.00 | 新加坡 |
验证是否成功
opencode models seedrise以seedrise/<id>的形式列出四个 Seedrise 模型。- 在 OpenCode 里,
/models显示 Seedrise provider,Claude 只显示whitelist中的模型。 opencode run -m seedrise/deepseek-v4-pro "Say hello"不打开界面也能返回结果,适合脚本和 CI。- 用量一分钟内出现在 Seedrise 控制台,按 Key 和模型列示。
常见报错
| 状态码 | 含义 | 处理方式 |
|---|---|---|
401 | Key 缺失、已停用或已过期。可能是启动 OpenCode 的 shell 里 SEEDRISE_API_KEY 为空,或 Claude 用上了之前通过 /connect 保存的 Anthropic Key。 | 检查 echo $SEEDRISE_API_KEY 和控制台里的 Key 状态;用 opencode auth logout 删除旧凭据。 |
403 | 该 Key 未开通此模型,或 IP 不在白名单 | 调整 Key 的模型列表或白名单 |
404 | 路径错误:anthropic 的 Base URL 缺少 /v1,Claude 请求被发到了 /messages;或 provider 用了 @ai-sdk/openai,调用了 /v1/responses。 | 两个 Base URL 都设为 https://api.seedrise.ai/v1,并使用 @ai-sdk/openai-compatible。 |
400 | 请求格式错误,通常是模型 ID 写错或请求体不合法 | 对照 GET /v1/models 核对模型 ID。如果 Claude 只在 anthropic provider 下出错,把该模型移到 seedrise.models 下,并把请求时间发给我们。 |
429 | 触发速率限制或额度用尽 | 退避重试;在控制台调高或联系我们 |
| 模型不显示 | 该 ID 不在 seedrise.models 下,或被 whitelist 隐藏。 | 把 ID 加进配置。如需 Claude 元数据,运行 opencode models --refresh。 |
还没解决?发邮件到 support@seedrise.ai,附上请求时间、模型 ID 和 Key 名称。
团队使用
把 opencode.json 提交到仓库,所有人使用同一套 provider 和模型,每位开发者各自在 SEEDRISE_API_KEY 中放自己的 Key。OpenCode 会合并多个配置文件,用下面这样一个短文件就能把 OpenCode 限定在 Seedrise 的 provider 上:
{
"$schema": "https://opencode.ai/config.json",
"enabled_providers": ["seedrise", "anthropic"],
"model": "anthropic/claude-sonnet-5-5",
"small_model": "anthropic/claude-haiku-5-5"
}- 要在公司设备上强制执行,把配置放进 OpenCode 的托管配置目录,用户无法覆盖:macOS 为
/Library/Application Support/opencode/,Linux 为/etc/opencode/,Windows 为%ProgramData%\opencode。 - 每个团队或项目单独一把 Key,账单上即可按项目看到花费。
- 每把 Key 都设置月额度。额度用尽后请求返回 429,agent 会停下,不会继续跑。
small_model负责会话标题等轻量任务,用 Haiku 5.5 成本更低。
OpenCode 常见问题
OpenCode 能通过 Seedrise 使用 Claude 吗? +
anthropic provider 指向 https://api.seedrise.ai/v1,走 Anthropic Messages 格式并沿用 OpenCode 的 Claude 模型元数据;或把 Claude 的 ID 加到 seedrise provider,走 Chat Completions。Seedrise provider 用哪个 npm 包? +
@ai-sdk/openai-compatible。它调用 /v1/chat/completions,Seedrise 对所有模型都提供这个接口。OpenCode 用 @ai-sdk/openai 调用 Responses API(/v1/responses),Seedrise 暂不提供。API Key 应该放在哪里? +
{env:SEEDRISE_API_KEY} 读取。也可以用 /connect 保存:选择 Other,输入 provider ID seedrise,OpenCode 会把它存到 ~/.local/share/opencode/auth.json。不要把 Key 写进会提交到仓库的 opencode.json。用哪些模型 ID? +
claude-sonnet-5-5、gpt-6.1-sol、deepseek-v4-pro。在 OpenCode 中按 provider/model 选择,例如 seedrise/deepseek-v4-pro。全部 ID 见模型库。Claude 推理能留在澳洲吗? +
来源
- 自定义 provider、Base URL、
whitelist与排错:opencode.ai/docs/providers,核对于 2026-11-02。 - 配置文件位置、合并规则、托管配置、
enabled_providers与{env:...}:opencode.ai/docs/config,核对于 2026-11-02。 opencode models与opencode run:opencode.ai/docs/cli,核对于 2026-11-02。
准备让 OpenCode 走 Seedrise?
1 个工作日内收到逐模型书面报价,然后是控制台账号和试用 Key。
另见:Claude Code 接入 · Cursor 接入 · 完整文档 · 套餐与价格 · 安全与数据
Seedrise 是独立服务商,与 Anthropic 无关联,也未获 Anthropic 背书。Claude 是 Anthropic, PBC 的商标。
OpenCode 是独立的开源项目,Seedrise 与其无关联。