Venice 聊天补全

这个技能解决什么问题

接入 LLM 文本生成时，通常要手写请求组装、响应解析、流式（SSE）处理一整套样板代码；更换供应商时，OpenAI 兼容层与非标准参数还得重新适配。本技能直接封装 Venice 的主文本端点 POST /api/v1/chat/completions：请求与响应均兼容 OpenAI 的 chat.completion 协议，同时通过 venice_parameters 对象暴露 Venice 独有的能力。已有 OpenAI 调用逻辑基本可以平移，不必重写协议层。

核心能力

• 文本生成：支持带工具或不带工具、流式或非流式两种调用方式。
• 多模态输入：可向具备视觉/音频能力的模型传入图片、音频、视频。
• Venice 专属功能：经 venice_parameters 启用网页搜索、E2EE、角色（characters）、xAI X/Twitter 搜索、strip-thinking、网页抓取等。
• Prompt 缓存：面向大型 system prompt 与长文档场景。
• 结构化输出：支持 json_schema 约束输出格式。

工作流程

1. 按 OpenAI 兼容格式组装请求体，核心字段沿用标准定义；
2. 把 Venice 专有配置放进 venice_parameters 对象；
3. 响应按标准 chat.completion 结构解析，读取 choices[].message 与 usage 等字段；
4. 当 stream: true 时，响应以 SSE 数据行返回，需按 chat.completion.chunk 格式逐块解析。

适用边界

• 这是文本主端点，并非 Venice 新的 Alpha 级 Responses API，后者应使用 venice-responses 技能；
• 核心字段走 OpenAI 兼容路径，但 Venice 特有行为必须经由 venice_parameters 传入，标准 OpenAI 参数并非全部映射；
• 多模态能力取决于所选模型本身是否支持视觉或音频输入；
• 逐字段细节以官方请求体文档为准，本文不做逐项展开。