跳到主要内容

Responses API

适用范围：HangToken 当前线上服务　最后核验：2026-08-26

Responses API 适合新建 Agent、工具调用与统一文本/多模态输入。若现有系统已稳定使用 Chat Completions，无需仅为接口形式迁移。

最小请求​

curl https://hangtoken.com/v1/responses \
  -H "Authorization: Bearer sk-[你的密钥]" -H "Content-Type: application/json" \
  -d '{"model":"[模型ID]","instructions":"回答简洁","input":"用一句话介绍 HangToken"}'

主要字段​

  • model：必填，使用控制台中的模型 ID。
  • input：字符串或输入项数组；复杂对话建议明确角色和内容类型。
  • instructions：全局行为说明。
  • tools：可用函数或其他工具；模型必须支持。
  • stream：开启后按事件类型消费增量结果。

读取结果​

const response = await client.responses.create({ model: "[模型ID]", input: "你好" });
console.log(response.output_text);

工具调用流程​

  1. 在请求中声明工具名称、用途和 JSON Schema。
  2. 模型返回工具调用后，由你的服务验证参数并执行。
  3. 把工具结果作为后续输入返回模型。
  4. 对支付、删除、发送消息等操作增加人工确认和幂等键。

迁移检查​

  • 不要假设 Chat 的 messages 可原样作为 input。
  • 先验证返回对象和流式事件，再迁移工具调用。
  • 存储你自己的业务会话 ID，不依赖上游对象永久保存。

具体事件类型和高级参数可能因模型兼容度变化；生产接入前请使用目标模型逐项测试。