SeedOne MODELS API
EN 中文
获取 API Key
菜单
模型定价文档安全 关于
English 登录
文档

五分钟，发出第一个请求。

继续用现有的 OpenAI 或 Anthropic SDK。两个入口共用一个 Key；按你的代码选择入口。

Base URL

两种协议共用同一域名。OpenAI 兼容 Base URL 含 /v1；Anthropic 兼容 Base URL 不含，端点本身已带 /v1。

协议Base URL端点
OpenAIhttps://models.seedone.ai/v1/chat/completions · /responses · /models
Anthropichttps://models.seedone.ai/v1/messages

同一把 Key 在两个入口通用。平台不做跨协议翻译：请按模型所在线路的协议调用，否则会以 protocol_mismatch 拒绝。Anthropic 兼容是协议层能力，不是模型来源：它让 Anthropic 兼容客户端调用本目录中的模型，目录本身并不包含 Anthropic 模型。

鉴权

两种请求头都支持。请勿把 Key 写入代码仓库或浏览器端代码。

http headers
Authorization: Bearer $SEEDONE_API_KEY
x-api-key: $SEEDONE_API_KEY

模型列表

返回这把 Key 当前可用的模型。范围由 Key 绑定的线路推导；换 Key 或改绑线路后请重新拉取。

curl
curl https://models.seedone.ai/v1/models \
  -H "Authorization: Bearer $SEEDONE_API_KEY"

对话请求

OpenAI 兼容、非流式。把模型占位符替换为 /v1/models 返回的真实模型名。

curl · openai
curl https://models.seedone.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
python · openai sdk
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://models.seedone.ai/v1",
    api_key=os.environ["SEEDONE_API_KEY"],
)

response = client.chat.completions.create(
    model="<model>",
    messages=[{"role": "user", "content": "Hello"}],
)

print(response.choices[0].message.content)

Anthropic 兼容示例

同一把 Key，不同入口。Anthropic 协议下 max_tokens 为必填。

curl · anthropic
curl https://models.seedone.ai/v1/messages \
  -H "x-api-key: ***" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

常见错误

每个响应都包含 x-request-id；报障时请附上。

code原因处理
invalid_api_keyKey 缺失、格式错误或已删除。检查请求头与 Key 值。
model_not_allowed模型不在这把 Key 的可用范围。改用 Key 所绑线路内的模型，或更换 Key。
insufficient_balance钱包余额不足。充值或使用兑换码。
window_exceeded达到 5h / 7d / 30d 套餐限额。购买对应档加油包、升级或续费。
concurrency_exceeded在途请求超过并发上限。降低并发或购买并发包。
rate_limited达到按 IP 的兜底限速。按 Retry-After 退避；检查重试风暴。
protocol_mismatch入口协议与模型协议不一致。按模型使用 /v1/chat/completions 或 /v1/messages。

限制

参数当前值
单请求体32 MB
首字节超时30 秒
单请求总时长15 分钟
默认输出上限16,384 tokens
上游重试≤ 2 次
IP 兜底限速120 请求 / 分钟 / IP
按量默认并发3（新号或曾欠费账号为 1）

完整参考（含全部错误码与一键自检）在控制台。 打开控制台文档 →

查看模型目录