-
v0.4.0 Stable
released this
2026-07-13 20:17:06 +08:00 | 30 commits to main since this releaseAdded
- 文本转语音端点
POST /ai/v1/audio/speech:OpenAI Audio Speech 兼容,直通 OCI 兼容面(模型xai.grok-tts,voice 取 xAI Grok Voice 列表ara/eve/leo/rex/sal);上游必填的language缺省时自动注入"auto",xAI 专属参数平铺透传;响应为一次性完整音频(Content-Type 透传上游,缺省 audio/mpeg),不提供流式 - 文档重排端点
POST /ai/v1/rerank:Jina / Cohere 通行协议,走 OCI typed 面(cohere.rerank-v4.0-pro/-fast),支持top_n与return_documents,results[].index指向入参documents下标 - 内容审核端点
POST /ai/v1/moderations:OpenAI moderations 外壳映射 OCI Guardrails(内容审核 / PII / 提示注入),input为字符串或字符串数组(单次至多 8 条),categories 用 OCI 原生维度overall/blocklist/prompt_injection(任一得分 ≥0.5 判flagged),PII 命中放扩展字段results[].pii(不参与 flagged;实测中文人名 / 手机号识别较弱,英文正常) - Responses 服务端工具扩展:放行 Oracle 文档化的 xAI
code_interpreter与远程mcp工具,并解除web_search/x_search仅非流式的限制——四类服务端工具非流式与流式均实测可用;code_interpreter的命名容器管理与 File Search 不提供 - 模型能力映射扩展:
TEXT_RERANK→ RERANK、TEXT_TO_AUDIO→ TTS,渠道探测 / 同步自动发现重排与语音模型入池
Changed
- AI 网关文档独立成篇
docs/ai-gateway.md(端点定位、兼容边界、已知上游限制、字段兼容矩阵——矩阵只列支持项,不支持 / 忽略项以文字简述),README 精简为概览并引用;实测披露:Responsesinput_file内容块被上游以 ZDR 形态拒绝,能力不可用 - swagger 全面修缺:135 处响应注解从泛型 map 改为具体类型(补文档用途响应结构与泛型列表外壳),AI 网关端点请求 / 响应 schema 完整可见;
json.RawMessage与联合类型统一渲染为任意 JSON 值(AnyJSON),不再误显示为 byte 数组;swag overrides 配置移至docs/.swaggo,生成命令加--overridesFile docs/.swaggo;顺带修正网页控制台会话创建响应码(200→201)与 SAML 元数据下载(改文件响应)两处注解失真
Downloads
- 文本转语音端点