技能介绍

要解决的问题

/chat/completions 把推理过程、正文、工具调用和内置工具事件全部塞进同一个 message.content。agent 需要区分「模型怎么想」「模型说了什么」「要调用哪个工具」时，只能自己在客户端做类型推断与字段拆分；流式输出下事件边界更加模糊。

核心能力

POST /api/v1/responses 返回 output[] 类型化数组，每个 block 的 type 明确：

reasoning：思考过程，summary[] 为可读文本，encrypted_content 是不透明签名，多轮工具调用需原样回传
message：主文本，content[].type === "output_text"，附带 web search 的 url_citation 注解
function_call：工具调用，含 name、字符串化 JSON 的 arguments、call_id
web_search_call：内置 web_search 触发哨兵，配合引用注解使用

input 接受纯字符串或类型化数组；系统提示用数组首条 role: "system"/"developer" 注入，续接工具结果按 call_id 匹配。stream: true 走 SSE，response.completed 与非流式响应形状一致，客户端按序重建 output[] 即可。

适用边界

Alpha 阶段，schema 可能变化，访问受 responsesApiEnabled flag 限制（x402 按次付费可绕过）。接口无状态，每次调用需发送完整历史。E2EE 模型默认拒绝，除非传 venice_parameters.enable_e2ee: false，完整 E2EE 流程仍要走 /chat/completions。venice_parameters 仅支持子集（character_slug、enable_web_search、enable_web_scraping、enable_web_citations、include_venice_system_prompt、include_search_results_in_stream），strip_thinking_response、disable_thinking 未接入。OpenAI Responses 的 instructions、metadata、response_format、store、previous_response_id 等字段不被支持；需要 JSON-schema 结构化输出时请回到 /chat/completions。