跳到主要内容

在 Zoo Code 和 Roo Code 中使用 OceanToken

Zoo Code 通过它的 OpenAI Compatible 提供商在 OceanToken 上运行。你要给它提供基础地址（Base URL）、API Key 和模型 ID，并设置几项模型能力。以下步骤已于 2026-10-18 对照 Zoo Code 3.90.0 实际发送的请求（使用它自己的工具定义）检查过：工具调用、流式输出、图像、推理强度和提示缓存。

Roo Code

Roo Code 已于 2026-05-15 关停，不再更新。Zoo Code 是延续它的社区项目。如果你仍装着 Roo Code，同样的步骤在那里也适用。它的设置相同，名称也相同，只有 Strict tool schemas 例外：Roo Code 总是发送严格的 schema，也就是第 7 步在 Zoo Code 中设置的效果。

开始之前​

为 Zoo Code 创建一个 API Key，并给它设置 消费上限。智能体会发出大量请求，消费上限决定了这个 API Key 最多能花多少钱。如何把 API Key 保存在环境变量中并检查它，见开始之前。

设置​

  1. 打开 Zoo Code 的设置，进入 Providers（提供商）。
  2. 把 API Provider（API 提供商）设为 OpenAI Compatible。
  3. 把 Base URL 设为 https://api.oceantoken.ai/v1。
  4. 把你的 OceanToken API Key 粘贴到 API Key。
  5. 把 Model 设为下表中的一个模型，例如 anthropic/claude-sonnet-5.5。Zoo Code 加载的列表包含你的 API Key 能用的所有模型，包括图像、视频和语音模型。请选择文本模型。
  6. 设置模型的能力：
    • Context Window Size：表中该模型的上下文窗口。
    • Max Output Tokens：32000。
    • Image Support（图像支持）：图像 列为「是」的模型打开。它默认是关闭的。
    • Prompt Caching（提示缓存）：Claude 模型打开，其他模型关闭（原因）。
    • 价格可以不填。Zoo Code 只用它们做自己的费用估算。
  7. Enable streaming 和 Strict tool schemas 保持打开。
  8. Model Reasoning Effort（模型推理强度）可选。Zoo Code 会以 reasoning_effort 把它发送给模型。
  9. 开始一个简短的任务，例如「列出这个文件夹里的文件」，检查设置是否正确。

这些模型都用 Zoo Code 的工具测试过。Max Output Tokens 保持 32,000：一轮编程对话很少需要更多，而较小的上限能限制单次回复的最高费用。每个模型的价格见它在 oceantoken.ai 上的页面，从 价格 一列点进去。模型页列出了所有模型。

模型 ID上下文窗口最大输出图像价格
anthropic/claude-sonnet-5.51,000,000128,000是在官网查看
anthropic/claude-opus-5.51,000,000128,000是在官网查看
anthropic/claude-haiku-4.5200,00064,000是在官网查看
openai/gpt-5.5922,000128,000是在官网查看
deepseek/deepseek-v4-pro1,048,576393,216否在官网查看
deepseek/deepseek-v4.1-flash1,048,576943,718是在官网查看
qwen/qwen3.8-flash983,616131,072是在官网查看
z-ai/glm-5.31,048,576943,718否在官网查看

提示缓存​

Zoo Code 每一轮都会发送同样的长提示，所以 缓存输入 价格和输入价格一样重要。

  • Claude 只在请求要求缓存时才缓存。打开 Prompt Caching 后，Zoo Code 会发出这个要求，从任务的第二轮起，提示中重复的部分按缓存输入价格计费。
  • GPT、DeepSeek、Qwen 和 GLM 模型会自动缓存，所以对它们保持 Prompt Caching 关闭。

Zoo Code 自己的费用估算可能没有计入缓存输入。每个请求的费用可以在控制台的日志中查看。

故障排查​

你看到的怎么处理
Invalid API key. Check the key, or create one in the OceanToken console.API Key 有误、已被撤销，或带了多余的空格。重新粘贴一次，或新建一个。
Unknown model '…'. GET /v1/models lists the models your key can use.模型 ID 要完全按照模型页的写法填写，前面带上发布方（写 deepseek/deepseek-v4-pro，而不是 deepseek-v4-pro）。
刚附加图片就出现 This model does not accept image input. 或 The upstream model provider returned an error.这个模型只能读文本。为它关闭 Image Support，或选择 图像 列为「是」的模型。
Insufficient balance - please add credit to continue.充值。如果你还有余额，请调低 Max Output Tokens：只有当你的余额足以支付这次回复可能产生的最高费用时，请求才会开始。
Claude 的费用比预期高为 Claude 模型打开 Prompt Caching。
模型列表里有几百个模型它列出了你的 API Key 能用的所有模型。直接输入上表中的模型 ID。