• v0.4.0 0a86b5a291

    v0.4.0
    CI / test (push) Successful in 32s
    Release / release (push) Successful in 1m4s
    Stable

    wangdefa released this 2026-07-13 20:17:06 +08:00 | 30 commits to main since this release

    Added

    • 文本转语音端点 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_nreturn_documentsresults[].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 精简为概览并引用;实测披露:Responses input_file 内容块被上游以 ZDR 形态拒绝,能力不可用
    • swagger 全面修缺:135 处响应注解从泛型 map 改为具体类型(补文档用途响应结构与泛型列表外壳),AI 网关端点请求 / 响应 schema 完整可见;json.RawMessage 与联合类型统一渲染为任意 JSON 值(AnyJSON),不再误显示为 byte 数组;swag overrides 配置移至 docs/.swaggo,生成命令加 --overridesFile docs/.swaggo;顺带修正网页控制台会话创建响应码(200→201)与 SAML 元数据下载(改文件响应)两处注解失真
    Downloads