OpenAI Responses Provider

文档首页 · Provider 指南 · 配置 · DeepSeek · OpenAI-compatible · Anthropic · Gemini · English

当所选模型由 OpenAI Responses API（/v1/responses）提供时，使用此 provider。它与 OpenAI-compatible provider 不同：后者使用 Chat Completions 协议，面向兼容网关。

最小配置

临时本地使用：

export SIGIL_OPENAI_RESPONSES_API_KEY="sk-..."
sigil

可复用配置：

[agent]
provider = "openai_responses"
model = "gpt-4.1"
tool_timeout_secs = 30

[model_request]
request_timeout_secs = 120
stream_idle_timeout_secs = 180

[providers.openai_responses]
base_url = "https://api.openai.com/v1"
# 优先使用 SIGIL_OPENAI_RESPONSES_API_KEY。
# api_key = "sk-..."
organization = "org_..."
project = "proj_..."

完整起点模板见 openai-responses.toml。

认证

Sigil 按这个顺序解析 Responses 认证：

1. SIGIL_OPENAI_RESPONSES_API_KEY
2. [providers.openai_responses].api_key

organization 和 project 只在账号要求时才需要。

环境变量覆盖

行为说明

该 provider 从 Responses event stream 输出 text、已支持的 reasoning delta、tool call 和 usage。每个完成的原生 output-item array 会作为不解释的 provider state 保存，并在后续请求中原样替换对应 assistant turn；这可以保留 encrypted reasoning content 等 provider 私有 item，而不会改动 Chat Completions provider 的契约。

普通请求使用完整本地 session context，不使用远端 response-handle continuation。此 provider 未启用 background request 与 provider-hosted tool。原生 compact endpoint 不是用户操作。

只有 Sigil 明确识别为支持图片的 model id（包括已支持的日期 snapshot）才能使用图片附件。未知 id、格式错误或未识别的 alias 会在 provider transport 前失败；Sigil 不会只根据 endpoint 猜测图片能力。输入方式、本地上限、cache 行为与 resume 建议见图片附件。

受控 overflow recovery 仅对官方 https://api.openai.com/v1 endpoint 与精确的 gpt-4.1-2025-04-14 snapshot 启用，并且必须是 provider 确认尚未产生 output 或 side effect 的 context-window rejection。request/session-owned preparation 会分别记录被拒请求与压缩后 target 的无生成 measurement；只有 exact before/after savings 与 target-fit proof 都通过后才进行一次 frozen retry。alias、兼容 endpoint、普通错误、计数失败、stale frontier、恢复后的 session 与递归恢复仍被排除。

验证

运行：

sigil doctor

确认 [agent].provider 是 openai_responses，base URL 包含预期 /v1 路径，且 key 来源是 SIGIL_OPENAI_RESPONSES_API_KEY 或本地配置。

常见问题