快速開始
從零到拿到模型回答，只要三步。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 Keys，選擇 Create key。Key 顯示時立即複製：它以 sk- 開頭，只會顯示一次。
每個新帳號註冊即有 $1 入門額度，14 天內有效，不需綁卡，所以第一個請求馬上就能執行。模型 ID 以 :free 結尾的模型在餘額為 $0 時也能呼叫；付費模型需要餘額大於 $0，想用更多時再儲值。每一步都有單獨的頁面可看細節：建立帳號、建立 API Key。
2. 把 Key 放進終端機
export OCEANTOKEN_API_KEY=sk-...
範例從這個環境變數讀取 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 數。這個請求會出現在主控台的 Logs 中，並附上費用。
整合只需要這些。API 與 OpenAI 相容，任何 OpenAI SDK 或工具只要填入 Base URL 和你的 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"
列表依你的 Key 而定：如果帳號只開放部分模型，就只會列出那些。所有模型都在 模型 頁面上，價格見 oceantoken.ai 上各模型的頁面。