Responses API

Responses API 适合 Codex、工具调用、推理和多轮响应场景。

POSThttps://www.hoofox.com/v1/responses

最小请求

curl https://www.hoofox.com/v1/responses \
  -H "Authorization: Bearer $HOOFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话介绍 Hoofox API"
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HOOFOX_API_KEY"],
    base_url="https://www.hoofox.com/v1",
)

response = client.responses.create(
    model="gpt-5.5",
    input="用一句话介绍 Hoofox API",
)

print(response.output_text)

常用参数

参数	类型	必填	说明
model	string	是	模型广场中的模型标识
input	string 或 array	否	文本或消息数组
instructions	string	否	系统级说明
max_output_tokens	integer	否	最大输出 Token 数
stream	boolean	否	是否使用流式响应
tools	array	否	可供模型调用的工具
reasoning	object	否	推理强度等设置
previous_response_id	string	否	继续上一轮响应

推理强度

对于支持推理的模型，可使用：

{
  "reasoning": {
    "effort": "high"
  }
}

可选值通常为 low、medium、high。模型不支持该参数时应移除。

成功响应

成功时返回响应对象，常见字段包括 id、status、model、output 和 usage。SDK 通常可以通过 output_text 读取聚合后的文本。