Responses 格式
OpenAI Responses API,用於建立模型回應。支援多輪對話、工具呼叫、推理等功能。
注意: 完整路徑為 POST /v1/responses。input 可為字串或訊息陣列;可透過 previous_response_id 延續多輪對話。
示例模型
下文均以 gpt-4o(GPT-4o)為例;更換其他模型時,請替換 model 參數,並參考控制台模型說明調整 size、quality 等欄位。
建立回應
POST
https://token.easyapi.com/v1/responses使用 OpenAI Responses API 建立模型回應,支援多輪對話、工具呼叫與推理。
請求參數
| 名稱 | 位置 | 類型 | 必選 | 說明 |
|---|---|---|---|---|
Authorization | header | string | 是 | EasyAPI API Key。格式:Bearer `API_KEY` |
Content-Type | header | string | 是 | 请求体格式,固定 application/json |
請求體
| 名稱 | 類型 | 必選 | 說明 |
|---|---|---|---|
model | string | 是 | 模型 ID |
input | string | array<object> | 否 | 輸入內容,可以是字串或訊息陣列 |
instructions | string | 否 | 系統級指令,影響模型行為 |
max_output_tokens | integer | 否 | 最大輸出 Token 數 |
temperature | number | 否 | 取樣溫度 |
top_p | number | 否 | 核取樣參數 |
stream | boolean | 否 | 是否串流回應 |
tools | array<object> | 否 | 可呼叫的工具定義列表 |
tool_choice | string | object | 否 | 工具選擇策略,字串或物件 |
reasoning | object | 否 | 推理相關設定 |
previous_response_id | string | 否 | 上一輪回應 ID,用於多輪對話 |
truncation | string | 否 | 截斷策略:auto |
示例
{
"model": "gpt-4o",
"input": "Hello!",
"instructions": "You are a helpful assistant.",
"max_output_tokens": 1024
}響應示例
{
"id": "resp_abc123",
"object": "response",
"created_at": 1718452800,
"status": "completed",
"model": "gpt-4o",
"output": [
{
"type": "message",
"id": "msg_abc123",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Hello! How can I help you today?"
}
]
}
],
"usage": {
"prompt_tokens": 15,
"completion_tokens": 12,
"total_tokens": 27,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 15,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 12,
"audio_tokens": 0,
"reasoning_tokens": 0
}
}
}