平台介绍

概览#

请求进入网关后会先被解析成统一中间表示，再按目标上游的方言重新编码。因此你可以用 OpenAI SDK 调 Claude，也可以用 Anthropic SDK 调 GPT；两条入口共用同一套路由、计费、限流与日志。

三个鉴权头等价，且全部端点通用：Authorization: Bearer（OpenAI SDK 与 curl）、x-api-key（Anthropic SDK）、api-key（Azure 风格）。推理 Key 一律以 sk-ar- 开头。

# OpenAI 兼容（大多数情况用这个）export OPENAI_BASE_URL=https://ai.oceango.hk/v1
# Anthropic SDKexport ANTHROPIC_BASE_URL=https://ai.oceango.hk

平台能做什么#

• 统一推理接口

  一个端点覆盖全目录，换模型只改 model 字段，不用改代码、不用换 SDK。

• 可编程路由

  单次请求就能声明「只走原厂」「价格优先」「限定区域」「拒绝会用于训练的通道」。

• 自动降级与熔断

  同一模型接多条线路，超时或报错自动换线；连续失败的线路会被熔断并在恢复后放回。

• 零完成保险

  没有任何产出的请求不收费，不论失败原因。

• 异步视频生成

  POST /v1/videos 创建任务、轮询状态、取产物，与对话端点同一把 Key。

• 逐笔可核对的账单

  每次调用都能查到走了哪条线路、单价、倍率与折扣，账单可以自己复算。

和直连供应商的差别#

• 一个 Key 覆盖全部模型，不用为每家上游各申请一次、各管一套配额与账单。
• 同一模型通常接了多条线路，某条线路抖动时请求会自动落到备用线路上，你的线上服务不跟着抖。
• 路由策略是可编程的：合规要求、价格上限、区域限制都能写在单次请求里，而不是只能接受平台的默认策略。
• 响应头会告诉你这次实际用了哪个模型、哪条线路、花了多少钱，便于对账与灰度对比。
• 空回复与全线失败不收费，重试成本为零。

相关但独立的模块#

联网搜索与网页阅读用的是另一套密钥与套餐（sk-srp- 开头），不和推理 Key 混用：拿推理 Key 调搜索接口会被拒绝，反之亦然。在控制台的搜索阅读页单独开通。

控制台的 Playground 可以不写代码先试：选中视频模型时参数面板会自动切换成视频参数，并给出可直接运行的代码片段。

下一步#

• 快速开始

  从注册到第一个成功的请求。

• 模型与路由

  模型名语法、变体、降级链与 provider 偏好。

• 计费口径

  公式、预扣与实结、零完成保险。

• 错误码

  统一信封、全部错误码与重试策略。