文件

Responses 格式

OpenAI Responses API,用於建立模型回應。支援多輪對話、工具呼叫、推理等功能。

欄位
Base URLhttps://token.easyapi.com/v1
認證Authorization: Bearer `API_KEY`
示例模型gpt-4o
格式OpenAI Responses 相容
計費按量計費
注意: 完整路徑為 POST /v1/responses。input 可為字串或訊息陣列;可透過 previous_response_id 延續多輪對話。

示例模型

下文均以 gpt-4o(GPT-4o)為例;更換其他模型時,請替換 model 參數,並參考控制台模型說明調整 size、quality 等欄位。

建立回應

POSThttps://token.easyapi.com/v1/responses

使用 OpenAI Responses API 建立模型回應,支援多輪對話、工具呼叫與推理。

請求參數

名稱位置類型必選說明
AuthorizationheaderstringEasyAPI API Key。格式:Bearer `API_KEY`
Content-Typeheaderstring请求体格式,固定 application/json

請求體

名稱類型必選說明
modelstring模型 ID
inputstring | array<object>輸入內容,可以是字串或訊息陣列
instructionsstring系統級指令,影響模型行為
max_output_tokensinteger最大輸出 Token 數
temperaturenumber取樣溫度
top_pnumber核取樣參數
streamboolean是否串流回應
toolsarray<object>可呼叫的工具定義列表
tool_choicestring | object工具選擇策略,字串或物件
reasoningobject推理相關設定
previous_response_idstring上一輪回應 ID,用於多輪對話
truncationstring截斷策略: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
    }
  }
}