PostV1ResponsesRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/paper-instruments/json-schema/paper-instruments-post-v1-responses-request-schema.json",
  "title": "PostV1ResponsesRequest",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/paper-instruments-openapi-generated.yml#/components/schemas/PostV1ResponsesRequest",
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Required. ultramarine-1-flash"
    },
    "input": {
      "type": "string",
      "description": "A string or an array of Responses input items. Default: []"
    },
    "instructions": {
      "type": "string",
      "description": "Optional string. Send instructions again on subsequent requests."
    },
    "reasoning": {
      "type": "object",
      "description": "reasoning.effort: low, high, or max. Default: max"
    },
    "max_output_tokens": {
      "type": "integer",
      "description": "Positive integer, including reasoning."
    },
    "store": {
      "type": "boolean",
      "description": "Only false is supported, which is the default."
    },
    "previous_response_id": {
      "type": "string",
      "description": "Unsupported."
    },
    "stream": {
      "type": "boolean",
      "description": "Boolean. Default: false."
    },
    "tools": {
      "type": "array",
      "description": "Array of function, mcp, or web_search definitions."
    },
    "tool_choice": {
      "type": "string",
      "description": "auto, none, required, or object"
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "description": "Boolean."
    },
    "max_tool_calls": {
      "type": "integer",
      "description": "Integer, 1–15; default: 4"
    },
    "text": {
      "type": "object",
      "description": "text.format field"
    },
    "temperature": {
      "type": "number",
      "description": "Number, 0–2. Default and recommended: 1"
    },
    "top_p": {
      "type": "number",
      "description": "Number, 0–1. Default and recommended: 0.95"
    },
    "metadata": {
      "type": "object",
      "description": "Up to 16 string pairs."
    },
    "prompt_cache_key": {
      "type": "string",
      "description": "Optional string cache hint."
    }
  },
  "required": [
    "model"
  ]
}