v1

latestOpenAPI 3.1.0Commercial2026-07-26232551.7 KB

Responses

Create a response

OpenAI Responses API. Supported on OpenAI models and xAI Grok models — xAI's Agent Tools API uses the same shape, so any Grok model accepts tools: [{"type": "web_search"}] / x_search / code_interpreter here. Anthropic and Gemini targets return not_implemented because their native shapes differ — for Anthropic call POST /v1/messages (Native Formats / Anthropic), for Gemini call POST /v1beta/models/{model}:generateContent (Native Formats / Gemini).

post/responses

Request body

modelstring required

instructionsstring

previous_response_idstring

ID of a prior response, to continue a multi-turn conversation without resending the full message history.

temperaturenumber

top_pnumber

max_output_tokensinteger

streamboolean

storeboolean

Whether the upstream may store the request/response. Allowed by default; channel setting disable_store can override.

metadataobject

Example request

{
  "model": "openai/gpt-4.1",
  "input": [
    {
      "content": [
        {
          "image_url": {
            "url": "https://example.com/photo.jpg"
          }
        }
      ]
    }
  ]
}