用途
该技能用于在需要复杂编码、计算机使用(computer use)和专业推理的场景下,通过 Frevana 的 OpenAI Responses API 调用固定模型 gpt-6.1-sol。接口地址为 POST https://ai-factory.frevana.com/openai/v1/responses。
主要能力
- 生成模型响应,支持文本与图像输入,输出为文本。图像输入需通过 --input-file 或 --raw-payload-file 以 Responses 消息数组形式提供。
- 支持提示词或 JSON 消息数组输入(--input、--prompt),以及 UTF-8 输入文件(--input-file)。
- 支持开发者指令(--instructions、--instructions-file)。
- 支持工具定义(--tools、--tools-file)与工具选择(--tool-choice:auto、required、none 或 JSON)。返回的客户端工具调用仍需调用方自行实现,脚本不会自动执行工具。
- 支持本地会话历史保存与重放(--session-file、--session),以及交互式终端聊天(--chat)。
- 支持纯文本输出(--text-only、-t)与完整响应 JSON 保存(--output)。
- 支持推理强度设置(--reasoning-effort:low、medium(默认)、high、xhigh、max)与最大输出 token 设置(--max-output-tokens:1–128000)。
- 支持服务层级选项(--service-tier:auto、default、flex、priority、ultrafast),但可用性取决于网关与账户,不应静默改用其他层级重试。
使用方式
需要 bash、curl、python3 以及 Frevana 认证。认证方式:使用 FREVANA_TOKEN 或 --token 作为 Authorization: Bearer;或使用 FREVANA_API_KEY 或 --api-key 作为 X-API-Key。显式标志会覆盖对应环境变量。该 Frevana 端点不使用 OpenAI API 密钥。
基本命令示例:
bash <skill-path>/scripts/create_response.sh \
--input "Design a distributed rate limiter in Go and explain the concurrency tradeoffs." \
--reasoning-effort high \
--output ./out/gpt-6.1-sol-response.json
使用同一会话文件继续对话:
bash <skill-path>/scripts/create_response.sh \
--session-file ./out/gpt-6.1-sol-session.json \
--input "Design a distributed rate limiter in Go and explain the concurrency tradeoffs." \
--text-only
bash <skill-path>/scripts/create_response.sh \
--session-file ./out/gpt-6.1-sol-session.json \
--input "Adapt the design to use Redis and explain the failure modes." \
--text-only
交互式聊天:
bash <skill-path>/scripts/create_response.sh --chat
离线验证(所有 HTTP 传输均为模拟,不产生计费请求):
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s <skill-path>/tests -v
本地会话状态
每次请求使用 store:false。启用本地会话时,脚本会先发送较早的输入/输出项,再发送新输入,并按顺序保存每个返回的输出项,包括助手阶段、加密推理、托管工具调用和客户端函数调用。客户端工具结果需以新的 function_call_output 项返回,并携带原始 call_id;脚本不会自动运行工具。
会话文件包含对话内容(含图像引用或内联图像数据)及开发者指令,使用私有文件权限(0600)和原子替换。认证头与 API 密钥不会被保存。指令会持续生效,直到被显式覆盖或重置;其他请求选项(包括工具定义)在后续非聊天调用中必须再次传入。
会话文件与模型和 API 源绑定。仅含旧式 response ID 的文件无法重建对话,会以说明性错误失败;可使用新文件或有意传入 --new-session。无效状态会在任何 API 调用前停止。同一会话文件一次只能运行一个调用。请求期间检测到状态变化会停止持久化,而不是覆盖另一轮对话。
API 错误和失败响应不会更新会话或已有输出。若在有效响应后本地持久化失败,脚本返回非零并打印包含响应和已完成历史的私有恢复文件路径;应保留该文件,不要重新提交同一轮。schema_version:1 的恢复文件可直接作为 --session-file 继续下一轮。
脚本每轮只发起一次请求,不自动重试、不截断历史、不摘要、不续写输出。历史会持续增长直到显式重置,并受模型上下文限制。使用 --no-session 时,调用方可自行管理历史,传入完整输入数组。
适用场景
- 复杂代码修改与系统设计。
- 计算机使用规划。
- 专业分析。
限制
- --model 仅接受 gpt-6.1-sol;脚本在原始负载中也会强制使用该模型。
- 该模型始终进行推理,不支持 none。采样参数(temperature、top_p、top_logprobs)会被拒绝,包括在原始负载中。
- 请求强制 store:false,包括原始负载。使用非流式前台请求;存储对话和 previous_response_id 会被拒绝。--previous-response-id 仅用于返回显式错误。
- 模型约束依据官方模型页面和 GPT-6 参数指南于 2026-11-03 核对,这些来源描述的是上游行为,并非 Frevana 的实时可用性检查。
- 服务层级为上游选项,通过 Frevana 的可用性取决于网关与账户。
- 脚本不执行客户端工具调用,需调用方自行实现。
- 不自动重试、不截断历史、不摘要、不续写输出。
- 同一会话文件一次只能运行一个调用。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。