文档

快速接入

Seedrise 用一个 API 接入主流文本、图像和视频模型。把现有的 OpenAI 或 Anthropic 客户端指向它，代码不用改，用报价单上的模型 ID 即可。

开通账号

索取报价单。 告诉我们你用的模型和大致月用量，1 个工作日内（澳东时间）收到逐模型书面报价。
收到控制台账号。 Seedrise 为你的公司在 console.seedrise.ai开通账号，不提供自助注册。
创建 Key。 在控制台按项目或环境创建 Key，每把 Key 可限制额度、模型、有效期和 IP 白名单。

端点与 Key

协议	Base URL	适用客户端
OpenAI Chat Completions	`https://api.seedrise.ai/v1`	OpenAI SDK、WorkBuddy、LangChain、LiteLLM 等任何 OpenAI 兼容客户端
Anthropic Messages	`https://api.seedrise.ai`	Claude Code、Anthropic SDK、DeepSeek Harness
模型列表	`GET /v1/models`	返回这把 Key 可调用的模型

每个请求带上 Authorization: Bearer sk-... 。Anthropic 风格客户端也可以用 x-api-key 头发送，两种都支持。Responses API（/v1/responses）暂未开放。

快速接入

用 curl 发第一个请求。模型换成报价单上任意 ID。

curl

curl https://api.seedrise.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"Hello"}]}'

# list the models your key can use
curl https://api.seedrise.ai/v1/models -H "Authorization: Bearer sk-..."

Claude Code

完整指南（含团队配置与排错）：在 Seedrise 上使用 Claude Code。

Claude Code 走 Anthropic Messages 协议，指向根 URL。设置一次环境变量，照常启动。

bash

export ANTHROPIC_BASE_URL="https://api.seedrise.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."                     # your Seedrise key
export ANTHROPIC_API_KEY=""                             # clear any personal key
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-5-5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

不要设置任何 CLAUDE_CODE_USE_* 云厂商开关，客户端以标准 Anthropic 格式直接对接网关。
如果之前用个人 Anthropic 账号登录过，先执行一次 /logout ，避免缓存的登录覆盖网关设置。
/status 命令应显示 Seedrise 网关地址和你的 token。
启动时 Claude Code 会请求 GET /v1/models 填充模型选择器；count_tokens 返回 404 属正常，Claude Code 会自动改用本地估算。
如果某个 beta 头被拒绝，设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。
Fable 5.1 仅对开通了该模型的 Key 可用，此时再设置 ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5-1" 。

要让整个团队只走网关，把以下内容写入托管的 settings.json：

json

{
  "allowedProviders": ["customEndpoint"],
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.seedrise.ai",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"
  }
}

WorkBuddy

完整指南：在 Seedrise 上使用 WorkBuddy。

WorkBuddy 走 OpenAI Chat Completions，把 Seedrise 添加为自定义模型。

提供方类型	自定义模型（Chat Completions）
API 地址	`https://api.seedrise.ai/v1`
API Key	你的 Seedrise Key
模型名	报价单上任意 ID，例如 `claude-sonnet-5-5` 或 `deepseek-v3.2`

Claude 模型由网关转换为 Anthropic Messages，工具调用和流式输出无需改动。

DeepSeek Harness

完整指南：在 Seedrise 上使用 DeepSeek Harness。

在 DeepSeek Harness 中添加自定义模型服务，协议选 Anthropic Messages。

服务类型	自定义模型服务 → Anthropic Messages
Base URL	`https://api.seedrise.ai`
API Key	你的 Seedrise Key
模型	`claude-sonnet-5-5` （或报价单上任意 Claude ID）

其他工具

任何支持自定义 OpenAI 兼容端点的工具都一样：填 base URL、Key、模型 ID。

工具	协议	Base URL	模型字段
Cursor	OpenAI（覆盖 base URL）	`https://api.seedrise.ai/v1`	报价单上任意 ID，例如 `claude-sonnet-5-5`
Cline / Roo Code	OpenAI Compatible 或 Anthropic	`/v1` 用于 OpenAI Compatible，Anthropic 用根 URL	报价单上的 ID
Cherry Studio	OpenAI 或 Anthropic 提供方	`https://api.seedrise.ai` （Cherry 会自动补 `/v1` ）	添加你用的 ID
Dify / LobeChat	OpenAI-API-compatible 提供方	`https://api.seedrise.ai/v1`	报价单上的 ID
LangChain / LiteLLM	OpenAI	`https://api.seedrise.ai/v1`	报价单上的 ID

只支持 Responses API（/v1/responses）的客户端暂时接不了，有需要请告诉我们。

OpenAI 与 Anthropic SDK

OpenAI SDK，Python

python

from openai import OpenAI

client = OpenAI(base_url="https://api.seedrise.ai/v1", api_key="sk-...")

r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Summarise this contract in three bullets."}],
)
print(r.choices[0].message.content)

OpenAI SDK，TypeScript，流式

typescript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.seedrise.ai/v1", apiKey: process.env.SEEDRISE_API_KEY });

const r = await client.chat.completions.create({
  model: "deepseek-v3.2",
  messages: [{ role: "user", content: "Write a release note for v2.1." }],
  stream: true,
});
for await (const chunk of r) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

Anthropic SDK，Python

python

import anthropic

client = anthropic.Anthropic(base_url="https://api.seedrise.ai", api_key="sk-...")

msg = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain data residency to a CFO."}],
)
print(msg.content[0].text)

图像和视频端点沿用同样的 OpenAI 请求格式，向我们索取你报价单对应的端点说明。

模型 ID

直接用厂商原始 ID，不加前缀。完整列表（价格、上下文、区域）见模型库。你的 Key 可调用的 ID 由 GET /v1/models。

区域与数据

标注 AU 的模型可按需固定在悉尼或墨尔本，按 Key 设置，而不是按请求。
提示词和输出从不用于训练。Seedrise 不留存请求和响应内容，只保留计费与审计所需的元数据。
数据处理协议按需提供，详见数据驻留部分。

限额与错误码

状态码	含义	处理方式
`400`	请求格式错误，通常是模型 ID 写错或请求体不合法	对照 `GET /v1/models`
`401`	Key 缺失、停用或过期	到控制台检查 Key
`403`	该 Key 未开通此模型，或 IP 不在白名单	调整 Key 的模型列表或白名单
`429`	触发速率限制或额度用尽	退避重试；在控制台调高或联系我们
`404`	端点不存在（例如 `count_tokens` 或 `/v1/responses`）	这些路径属正常；其他情况检查 base URL
`5xx`	上游或网关错误	退避重试；网关会自动在路由间切换

默认速率限制在开户时按 Key 设置，可按需调高。长请求走流式；推理模型请把客户端超时设为 10 分钟以上。

以下功能不通过 Seedrise 提供：服务端网页搜索与网页抓取工具（包括 Claude Code 内置的 WebSearch）、代码执行、Batch API、/v1/messages/count_tokens 和 /v1/responses。

支持

发邮件至 sales@seedrise.ai，注明公司名称；如遇报错，请附上响应头中的请求 ID。1 个工作日内（澳东时间）回复。用量阶梯与承诺用量账户有专属联系人和共享频道。