快速开始
从零到拿到模型的回答，只要三步。基础地址（Base URL）：https://api.oceantoken.ai/v1。
在 Claude Code 里输入这两条命令安装 OceanToken 插件，然后运行 /mcp 登录。详细说明。
/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken
1. 拿到 API Key
注册，然后在控制台打开 API Key，点击 创建 API Key。API Key 只显示一次，请当场复制，它以 sk- 开头。
每个新账户注册即有 $1 起步额度，14 天内有效，无需绑卡，所以第一个请求马上就能跑。模型 ID 以 :free 结尾的模型在余额为 $0 时也能调用；付费模型需要余额大于 $0，想用更多时再充值。每一步都有单独的页面说明细节：创建账户、创建 API Key。
2. 在终端里设置 API Key
export OCEANTOKEN_API_KEY=sk-...
示例都从这个环境变量读取 API Key，所以它不会出现在代码里。Windows PowerShell 中：$env:OCEANTOKEN_API_KEY = "sk-..."。
3. 发出请求
- curl
- Python
- Node.js / TypeScript
# Chat completion with curl. Any OpenAI-compatible client works the same way:
# point it at the base URL and use your OceanToken key.
curl -sS "${OCEANTOKEN_BASE_URL:-https://api.oceantoken.ai/v1}/chat/completions" \
-H "Authorization: Bearer $OCEANTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4.1-flash-1017",
"messages": [{"role": "user", "content": "Say hello in one short sentence."}]
}'
# pip install openai
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("OCEANTOKEN_BASE_URL", "https://api.oceantoken.ai/v1"),
api_key=os.environ["OCEANTOKEN_API_KEY"],
)
response = client.chat.completions.create(
model="deepseek/deepseek-v4.1-flash-1017",
messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)
print(response.choices[0].message.content)
// npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: process.env.OCEANTOKEN_BASE_URL ?? "https://api.oceantoken.ai/v1",
apiKey: process.env.OCEANTOKEN_API_KEY,
});
const response = await client.chat.completions.create({
model: "deepseek/deepseek-v4.1-flash-1017",
messages: [{ role: "user", content: "Say hello in one short sentence." }],
});
console.log(response.choices[0].message.content);
保存为 chat.mjs（或保存为 chat.ts 并用 npx tsx chat.ts 运行），然后运行 node chat.mjs。
你会收到标准的 chat completion 对象：回答在 choices[0].message.content 里，usage 里是本次计费的 token 数。这次请求会出现在控制台的 日志 里，并显示费用。
接入只需要这些。API 兼容 OpenAI，所以任何 OpenAI SDK 或工具只要填上基础地址和你的 API Key 就能用，model 的值是模型页上的名称。所有对话模型（包括 Claude）也都可以通过 Anthropic Messages API 调用：Anthropic SDK 会自己加上 /v1，所以它要填 https://api.oceantoken.ai（见下文）。
本页的每个示例都是一个真实的文件，发布前我们都会实际运行一遍。设置好 OCEANTOKEN_API_KEY，示例即可原样运行。
流式输出回答
只要有人在等结果，就用流式输出。token 一生成就会送达，长回答也不会碰到限制中说明的请求超时。
# Streaming: tokens arrive as they are generated. Use this for anything a person
# is waiting on, and for long answers, which would otherwise hit the request timeout.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("OCEANTOKEN_BASE_URL", "https://api.oceantoken.ai/v1"),
api_key=os.environ["OCEANTOKEN_API_KEY"],
)
with client.chat.completions.create(
model="deepseek/deepseek-v4.1-flash-1017",
messages=[{"role": "user", "content": "Count from one to five, one number per line."}],
stream=True,
) as stream:
for chunk in stream:
delta = chunk.choices[0].delta.content if chunk.choices else None
if delta:
print(delta, end="", flush=True)
print()
通过 Anthropic SDK 使用 Claude
# pip install anthropic
# Claude models are served on /v1/messages. The Anthropic SDK works unchanged:
# give it the OceanToken host and your OceanToken key. It adds /v1 itself, so it
# takes the base URL without the /v1 that OpenAI SDKs need.
import os
import anthropic
client = anthropic.Anthropic(
base_url=os.getenv("OCEANTOKEN_BASE_URL", "https://api.oceantoken.ai/v1").removesuffix("/v1"),
api_key=os.environ["OCEANTOKEN_API_KEY"],
)
message = client.messages.create(
model="anthropic/claude-haiku-4.5",
max_tokens=64,
messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)
print(message.content[0].text)
同样的代码也适用于其他对话模型，比如 deepseek/deepseek-v4.1-flash-1017：改 model 即可。
查看可以调用的模型
# The models your key can call, in the standard list format.
curl -sS "${OCEANTOKEN_BASE_URL:-https://api.oceantoken.ai/v1}/models" \
-H "Authorization: Bearer $OCEANTOKEN_API_KEY"
返回的列表取决于你的 API Key：如果你的账户只开放了部分模型，列表里只会出现这些模型。所有模型都在模型页，价格见 oceantoken.ai 上各模型的页面。