SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场gpt-6.1-terra

gpt-6.1-terra

智能体与模型

查看项目

更新于 11-05 05:15

技能介绍

用途

gpt-6.1-terra 用于通过 Frevana 的 OpenAI Responses API（POST https://ai-factory.frevana.com/openai/v1/responses）调用固定模型 gpt-6.1-terra。资料列出的典型用途包括：解读图像与技术图纸、规划屏幕交互（computer-use planning）、聚焦式代码修复，以及起草或修订文本。

主要能力

  • 输入输出：支持文本和图像输入，输出为文本。图像输入需通过 --input-file 或 --raw-payload-file 以 Responses 消息数组形式提供。
  • 模型固定：--model 仅接受 gpt-6.1-terra，原始负载中的模型也会被强制为该值。
  • 参数：--reasoning-effort（none、low、medium、high、xhigh、max，默认 medium，省略则交由服务器决定）；--max-output-tokens（1–128000）；--service-tier（auto、default、flex、priority，属于上游选项，是否能通过 Frevana 使用取决于网关和账户，不应静默改用其他层级）；--temperature（0–2）与 --top-p（0–1）仅在 reasoning.effort 显式为 none 时可用，否则请求会被拒绝。
  • 指令与工具：--instructions / --instructions-file 提供开发者指令；--tools / --tools-file 提供 JSON 工具定义，--tool-choice 可取 auto、required、none 或 JSON。返回的客户端工具调用仍需调用方自行实现，该工具不会自动执行。
  • 会话：--session-file 保存并重放本地对话历史，后续只需传入新一轮输入或新的工具结果项；--session 使用 ~/.frevana/sessions 下的命名会话，也可通过 FREVANA_SESSION_ID、CONVERSATION_ID、SESSION_ID 指定身份，FREVANA_SESSION_DIR 可覆盖目录。
  • 输出控制：--text-only / -t 只打印提取的响应文本；--output 保存完整响应 JSON。
  • 交互模式：--chat 提供带本地历史重放的终端交互聊天。

使用方式

需具备 bash、curl、python3 和 Frevana 认证。可用 FREVANA_TOKEN 或 --token 提供 Authorization: Bearer，或用 FREVANA_API_KEY 或 --api-key 提供 X-API-Key；显式参数优先于对应环境变量。该端点不使用 OpenAI API 密钥。

示例命令：

bash <skill-path>/scripts/create_response.sh
--input "Review this API design and suggest focused improvements."
--reasoning-effort high
--output ./out/gpt-6.1-terra-response.json

继续同一会话：

bash <skill-path>/scripts/create_response.sh
--session-file ./out/gpt-6.1-terra-session.json
--input "Review this API design and suggest focused improvements."
--text-only

bash <skill-path>/scripts/create_response.sh
--session-file ./out/gpt-6.1-terra-session.json
--input "Rewrite the recommendations as a concise implementation checklist."
--text-only

交互聊天：

bash <skill-path>/scripts/create_response.sh --chat

离线验证：

PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s <skill-path>/tests -v

测试中的 HTTP 传输均为模拟，不会产生计费请求。

本地会话与状态

每次请求均使用 store:false。启用本地会话时，工具会先发送此前的输入/输出项，再发送新输入，并按顺序保存返回的每个输出项，包括 assistant 阶段、加密推理内容、托管工具调用和客户端函数调用。客户端工具结果需以新的 function_call_output 项、携带原始 call_id 返回。会话文件包含对话内容（含图像引用或内联图像数据）和开发者指令，权限为 0600 并采用原子替换；认证头和 API 密钥不保存。指令会持续生效，直到被显式覆盖或重置；工具定义等其他请求选项在后续非聊天调用中需重新传入。

--previous-response-id 仅用于返回明确错误：由于强制 store:false，上游响应 ID 无法恢复上下文，应改用本地会话文件。--new-session / --new 以空历史开始，并在成功响应后才替换旧文件。--no-session 禁用持久化，聊天模式下历史仅保留于本次运行。

限制

  • 每轮仅发起一次请求，没有自动重试、历史截断、摘要或输出续写；历史会持续增长，直至显式重置，并受模型上下文上限约束。
  • 工具不会自动执行客户端工具调用。
  • 请求需为非流式前台请求；存储式会话和 previous_response_id 会被拒绝。
  • 同一会话文件一次只能运行一个调用；请求期间检测到状态变化会停止持久化。
  • API 错误和失败响应不会更新会话或已有输出；若有效响应后本地持久化失败，工具返回非零状态并打印私有恢复文件路径，应保留该文件而不是重新提交同一轮；schema_version:1 的恢复文件可直接作为 --session-file 继续使用。
  • 会话文件与模型和 API 来源绑定；旧式仅含响应 ID 的文件无法重建对话。
  • 模型约束基于 2026-11-03 对官方模型页和 GPT-6 参数说明的核对，这些来源描述的是上游行为，并不代表 Frevana 的实时可用性检查。

适用场景

适合需要通过 Frevana 以固定模型进行图像/图纸解读、屏幕操作规划、定向代码修改和多轮文本修订的脚本化或终端交互场景。