Helicone · Schema

OpenAIChatRequest

Simplified interface for the OpenAI Chat request format

AI GatewaysAI MonitoringGatewaysLLM ObservabilityLLM RoutingPrompt Management

Properties

Name Type Description
model string
messages array
temperature number
top_p number
max_tokens number
max_completion_tokens number
stream boolean
stop object
tools array
tool_choice object
parallel_tool_calls boolean
reasoning_effort string
verbosity string
frequency_penalty number
presence_penalty number
logit_bias object
logprobs boolean
top_logprobs number
n number
modalities array
prediction object
audio object
response_format object
seed number
service_tier string
store boolean
stream_options object
metadata object
user string
function_call object
functions array
View JSON Schema on GitHub

JSON Schema

helicone-openaichatrequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/OpenAIChatRequest",
  "title": "OpenAIChatRequest",
  "description": "Simplified interface for the OpenAI Chat request format",
  "properties": {
    "model": {
      "type": "string"
    },
    "messages": {
      "items": {
        "properties": {
          "tool_calls": {
            "items": {
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "function"
                  ],
                  "nullable": false
                },
                "function": {
                  "properties": {
                    "arguments": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "arguments",
                    "name"
                  ],
                  "type": "object"
                },
                "id": {
                  "type": "string"
                }
              },
              "required": [
                "type",
                "function",
                "id"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "tool_call_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "content": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "properties": {
                    "image_url": {
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "url"
                      ],
                      "type": "object"
                    },
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "type"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            ],
            "nullable": true
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "content",
          "role"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "temperature": {
      "type": "number",
      "format": "double"
    },
    "top_p": {
      "type": "number",
      "format": "double"
    },
    "max_tokens": {
      "type": "number",
      "format": "double"
    },
    "max_completion_tokens": {
      "type": "number",
      "format": "double"
    },
    "stream": {
      "type": "boolean"
    },
    "stop": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "string"
        }
      ]
    },
    "tools": {
      "items": {
        "properties": {
          "function": {
            "properties": {
              "strict": {
                "type": "boolean"
              },
              "parameters": {
                "$ref": "#/components/schemas/Record_string.any_"
              },
              "description": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "type": "object"
          },
          "type": {
            "type": "string",
            "enum": [
              "function"
            ],
            "nullable": false
          }
        },
        "required": [
          "function",
          "type"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "tool_choice": {
      "anyOf": [
        {
          "properties": {
            "function": {
              "properties": {
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "function"
                  ],
                  "nullable": false
                }
              },
              "required": [
                "name",
                "type"
              ],
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        },
        {
          "type": "string",
          "enum": [
            "none",
            "auto",
            "required"
          ]
        }
      ]
    },
    "parallel_tool_calls": {
      "type": "boolean"
    },
    "reasoning_effort": {
      "type": "string",
      "enum": [
        "minimal",
        "low",
        "medium",
        "high"
      ]
    },
    "verbosity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "frequency_penalty": {
      "type": "number",
      "format": "double"
    },
    "presence_penalty": {
      "type": "number",
      "format": "double"
    },
    "logit_bias": {
      "$ref": "#/components/schemas/Record_string.number_"
    },
    "logprobs": {
      "type": "boolean"
    },
    "top_logprobs": {
      "type": "number",
      "format": "double"
    },
    "n": {
      "type": "number",
      "format": "double"
    },
    "modalities": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "prediction": {},
    "audio": {},
    "response_format": {
      "properties": {
        "json_schema": {},
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "seed": {
      "type": "number",
      "format": "double"
    },
    "service_tier": {
      "type": "string"
    },
    "store": {
      "type": "boolean"
    },
    "stream_options": {},
    "metadata": {
      "$ref": "#/components/schemas/Record_string.string_"
    },
    "user": {
      "type": "string"
    },
    "function_call": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "name": {
              "type": "string"
            }
          },
          "required": [
            "name"
          ],
          "type": "object"
        }
      ]
    },
    "functions": {
      "items": {},
      "type": "array"
    }
  },
  "type": "object",
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/helicone-openaichatrequest"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.