AI API Gateway

Worker 地址

https://ai-api-gateway.hb67egcim4.workers.dev

鉴权 Header：X-Gateway-Token · 归因：X-Caller-Worker

路由模式

options.routing	说明
`auto` / `cost_optimal`	按 config/routes.json 顺序尝试，跳过额度用尽/不健康后端
`explicit`	必须同时指定 `options.provider` + `options.model`
`free_only`	仅用免费额度后端（CF m2m100、Azure F0 等）
`quality_first`	优先 Vertex Pro 等高质量模型
`vertex_only` / `azure_only` / `cf_only`	锁定单一云厂商

能力一览

capability	路径	说明
vision.ocr	POST /v1/vision.ocr	截图识标题/作者
translate	POST /v1/translate	字幕/文本翻译
chat	POST /v1/chat	文本生成 / 分析
stt	POST /v1/stt	Whisper 转录
tts	POST /v1/tts	语音合成（返回音频二进制）
audio.diarize	POST /v1/audio.diarize	说话人+翻译（规划中）

自动路由示例

curl -X POST "$WORKER/v1/translate" \
  -H "Content-Type: application/json" \
  -H "X-Gateway-Token: $TOKEN" \
  -H "X-Caller-Worker: youtube-translate" \
  -d '{
    "input": {
      "segments": [{"start":0,"end":1,"text":"Hello"}],
      "target_lang": "zh"
    },
    "options": { "routing": "cost_optimal" }
  }'

指定路由示例

curl -X POST "$WORKER/v1/vision.ocr" \
  -H "Content-Type: application/json" \
  -H "X-Gateway-Token: $TOKEN" \
  -d '{
    "input": { "image_base64": "...", "mime": "image/png" },
    "options": {
      "routing": "explicit",
      "provider": "vertex",
      "model": "gemini-3.1-flash-lite-preview"
    }
  }'

今日用量

输入 Gateway Token 后加载（仅存于浏览器 localStorage）

新增 AI 能力

详见仓库文档：

ai-api-gateway/DESIGN.md — 架构与路由设计
ai-api-gateway/docs/ADDING_CAPABILITY.md — 分步接入清单

配置三件套：config/models.json · config/routes.json · src/capabilities/