Skip to main content
POST
Responses
/v1/responses is OpenAI’s newer endpoint that manages multi-step conversations and tool calls with a unified response object, suited to agent scenarios.
OpenAI now positions the Responses API as the recommended default interface — prefer it for new projects; Chat Completions remains supported long-term with backward compatibility.

Differences from chat/completions

Request

Main parameters

Response

You can get the merged text directly via response.output_text (an SDK helper field).

Multi-turn conversation

The second turn doesn’t resend history — use previous_response_id:
You must pass store: true in the first request so OpenPAI retains the state.

Reasoning

Built-in tools

Supported built-in tools (subject to upstream availability):
  • web_search — search the web
  • file_search — retrieve from uploaded files
  • code_interpreter — execute code in a sandbox
Some built-in tools depend on the upstream environment; OpenPAI passes the results through.