从 OpenAI、Anthropic 或其他 API 迁移

OceanToken 兼容 OpenAI API，所有对话模型也都支持 Anthropic Messages API。迁移一个应用只需改两项设置（基础地址和 API Key），再改一下模型名称。

从 OpenAI SDK 迁移

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.oceantoken.ai/v1",  # 原来是 https://api.openai.com/v1
    api_key=os.environ["OCEANTOKEN_API_KEY"],  # OceanToken 的 API Key，sk-...
)

TypeScript 中对应的选项是 baseURL 和 apiKey。然后在每个模型名称前加上发布方：gpt-5-mini 改成 openai/gpt-5-mini。所有 ID 见模型页。

完全不改代码： Python 和 Node.js 的 OpenAI SDK 会读取两个环境变量，所以不带参数创建客户端的应用，只要设置

export OPENAI_BASE_URL=https://api.oceantoken.ai/v1
export OPENAI_API_KEY=$OCEANTOKEN_API_KEY

再改用新的模型名称即可迁移。很多基于 OpenAI SDK 的工具也读取这两个变量。

从 Anthropic SDK 迁移

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.oceantoken.ai",  # 不带 /v1：SDK 会自己加上
    api_key=os.environ["OCEANTOKEN_API_KEY"],
)

也可以设置 ANTHROPIC_BASE_URL=https://api.oceantoken.ai，并把 ANTHROPIC_API_KEY 设为你的 OceanToken API Key。Claude 模型的名称是 anthropic/claude-sonnet-4.6、anthropic/claude-haiku-4.5 等；同样的代码按 ID 就能调用 OceanToken 上的其他任何对话模型。

从其他多模型 API 迁移

如果你在用另一个通过 OpenAI 兼容 API 提供多种模型的服务：

基础地址和 API Key： https://api.oceantoken.ai/v1 和你的 OceanToken API Key。
模型 ID 同样是 发布方/模型 的形式，所以大多数可以原样沿用。请用 GET /v1/models 或模型页逐个核对；不存在的名称会以 400 model_not_found 被拒绝，绝不会被换成别的模型。
备用模型： 放在 fallbacks 里，这是一个模型 ID 列表，你的模型失败时按顺序尝试（重试与自动故障转移）。不支持其他指定备用模型的方式。
用来挑选托管服务商的路由偏好和署名请求头都不需要，也不支持。每个模型都由官方或授权的来源提供，来源之间自动故障转移，价格也不随回答的来源变化（重试与自动故障转移）。
这里同样有 :free 模型。
视频使用 POST /v1/videos，生成一个需要轮询的任务（视频）。

相同的地方

各格式的请求体和响应体，包括流式输出、工具调用、图片输入和结构化输出。
错误的外层结构 {"error": {"message", "type", "param", "code"}}。
所有兼容 OpenAI 的 SDK 和框架：设置基础地址和 API Key 即可。指南：Vercel AI SDK、编程智能体。

不同的地方

方面	在 OceanToken 上
模型不支持的参数	会被丢弃，请求照常运行。响应成功不能证明参数生效了（使用哪种 API 格式）。
错误	少数状态码不同：余额用完是 `400 insufficient_credits`，不是 `429`；未知模型是 `400`。请按 `code` 判断（从 OpenAI 迁移）。
不提供的功能	批处理、微调，以及列出或读取已上传的文件，会返回 `501 not_supported`（错误）。请把每个请求发到它对应的常规端点。
计费	预付费：余额大于 $0 时请求才会运行。每个 API Key 可以单独设置消费上限（创建 API Key）。
请求的费用	`x-oceantoken-cost` 响应头；流式请求用 `GET /v1/usage/{request_id}` 查询；控制台的日志（请求的费用）。
生成的媒体	图片和视频以链接形式返回，有效期 24 小时；需要保留的请及时下载（限制 → 保留期限）。
请求 ID	记录 `x-oceantoken-request-id` 响应头，联系我们时请提供它（错误）。

检查清单

为应用创建一个 API Key 并设置消费上限，然后充值。
修改基础地址和 API Key，或设置上面的环境变量。
改模型名称；用 GET /v1/models 逐个核对。
如果你的代码按错误状态码分支处理，请阅读错误；只重试可以重试的错误。
跑一遍测试，包括你依赖的每个参数各测一次，并在控制台的日志里检查这些请求。

从 OpenAI SDK 迁移​

从 Anthropic SDK 迁移​

从其他多模型 API 迁移​

相同的地方​

不同的地方​

检查清单​