Venice.ai · Schema
Responses API Request
Request body for the Responses API endpoint. E2EE-capable models are not supported on /api/v1/responses; use /api/v1/chat/completions with the required E2EE headers instead.
CompanyArtificial IntelligenceLLMImage GenerationVideo GenerationText-to-SpeechEmbeddingsPrivacyOpenAI-Compatiblex402
Properties
| Name | Type | Description |
|---|---|---|
| model | string | The ID of the model to use. E2EE-capable models are not supported on /api/v1/responses; use /api/v1/chat/completions with the required E2EE headers instead. |
| input | object | The input to generate a response for. Can be a simple string or an array of messages. |
| instructions | stringnull | System instructions for the model, applied before `input`. |
| include | array | Additional response fields to include (OpenAI-compatible). |
| max_output_tokens | integer | Maximum number of tokens to generate. |
| temperature | number | Sampling temperature between 0 and 2. |
| top_p | number | Nucleus sampling parameter. |
| fallbacks | array | Anthropic beta parameter for Claude Fable 5 server-side refusal fallback. Forwarded only for direct Anthropic routes; ignored for other providers. |
| reasoning | objectnull | Reasoning controls for models that support reasoning. |
| parallel_tool_calls | boolean | Whether the model may call more than one tool in a single turn. |
| tools | array | A list of tools the model may call. |
| tool_choice | object | Controls which tool is called by the model. |
| prompt_cache_retention | string | Prompt cache retention for supported OpenAI models. "24h" or "extended" keeps cached prefixes for up to 24 hours. |
| web_search | boolean | Enable web search for this request. |
| stream | boolean | Whether to stream back partial progress. |
| anon_user_id | string | Optional identifier for the API customer's end user. Combined with the Venice user id when attributing the request to upstream providers. Distinct from the discarded OpenAI `user` field. Must be print |
| venice_parameters | object | Venice-specific options, such as web search, characters, and the Venice system prompt. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/venice-ai/main/json-schema/venice-ai-responses-request-schema.json",
"title": "Responses API Request",
"description": "Request body for the Responses API endpoint. E2EE-capable models are not supported on /api/v1/responses; use /api/v1/chat/completions with the required E2EE headers instead.",
"x-generated": "2026-10-13",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/venice-ai-openapi.yml#/components/schemas/ResponsesRequest",
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "The ID of the model to use. E2EE-capable models are not supported on /api/v1/responses; use /api/v1/chat/completions with the required E2EE headers instead."
},
"input": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"message"
]
},
"role": {
"type": "string",
"enum": [
"user",
"assistant",
"system",
"developer"
]
},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"input_text"
]
},
"text": {
"type": "string"
}
},
"required": [
"type",
"text"
],
"title": "Input Text"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"input_image"
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high",
"original"
]
}
},
"required": [
"url"
]
}
]
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high",
"original"
]
}
},
"required": [
"type",
"image_url"
],
"title": "Input Image"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"output_text"
]
},
"text": {
"type": "string"
},
"annotations": {
"type": "array",
"items": {
"nullable": true
}
}
},
"required": [
"type",
"text"
],
"title": "Output Text (for history)"
}
]
}
}
]
},
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"in_progress",
"incomplete"
]
}
},
"required": [
"type",
"role",
"content"
],
"title": "Input Message"
},
{
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"user",
"assistant",
"system",
"developer"
]
},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"input_text"
]
},
"text": {
"type": "string"
}
},
"required": [
"type",
"text"
],
"title": "Input Text"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"input_image"
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high",
"original"
]
}
},
"required": [
"url"
]
}
]
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high",
"original"
]
}
},
"required": [
"type",
"image_url"
],
"title": "Input Image"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"output_text"
]
},
"text": {
"type": "string"
},
"annotations": {
"type": "array",
"items": {
"nullable": true
}
}
},
"required": [
"type",
"text"
],
"title": "Output Text (for history)"
}
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"text"
]
},
"text": {
"type": "string"
}
},
"required": [
"type",
"text"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"image_url"
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high",
"original"
]
}
},
"required": [
"url"
]
}
]
}
},
"required": [
"type",
"image_url"
]
}
]
}
}
]
},
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"in_progress",
"incomplete"
]
}
},
"required": [
"role",
"content"
],
"title": "Input Message (Flexible)"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"reasoning"
]
},
"id": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"array",
"null"
],
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"summary_text"
]
},
"text": {
"type": "string"
}
},
"required": [
"type",
"text"
]
}
]
}
},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"nullable": true
}
},
{
"nullable": true,
"title": "null"
},
{
"nullable": true,
"title": "null"
}
]
},
"encrypted_content": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
],
"enum": [
"completed",
"in_progress"
]
}
},
"required": [
"type"
],
"title": "Reasoning"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"function_call"
]
},
"id": {
"type": "string"
},
"call_id": {
"type": "string"
},
"name": {
"type": "string"
},
"namespace": {
"type": "string"
},
"arguments": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"in_progress",
"incomplete"
]
}
},
"required": [
"type",
"call_id",
"name",
"arguments"
],
"title": "Function Call"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"function_call_output"
]
},
"call_id": {
"type": "string"
},
"output": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"nullable": true
}
},
{
"type": "object",
"additionalProperties": {
"nullable": true
}
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"nullable": true,
"title": "null"
},
{
"nullable": true,
"title": "null"
}
]
}
},
"required": [
"type",
"call_id",
"output"
],
"title": "Function Call Output"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"item_reference"
]
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
],
"title": "Item Reference"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"custom_tool_call"
]
},
"id": {
"type": "string"
},
"call_id": {
"type": "string"
},
"name": {
"type": "string"
},
"namespace": {
"type": "string"
},
"input": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"in_progress",
"incomplete"
]
}
},
"required": [
"type",
"call_id",
"name",
"input"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"custom_tool_call_output"
]
},
"call_id": {
"type": "string"
},
"output": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"nullable": true
}
},
{
"type": "object",
"additionalProperties": {
"nullable": true
}
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"nullable": true,
"title": "null"
},
{
"nullable": true,
"title": "null"
}
]
}
},
"required": [
"type",
"call_id",
"output"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"additional_tools"
]
},
"role": {
"type": "string",
"enum": [
"developer"
]
},
"tools": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"function"
]
},
"defer_loading": {
"type": "boolean"
},
"function": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"parameters": {
"type": "object",
"additionalProperties": {
"nullable": true
}
},
"strict": {
"type": "boolean"
},
"defer_loading": {
"type": "boolean"
}
},
"required": [
"name"
]
}
},
"required": [
"type",
"function"
],
"title": "Function Tool"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"tool_search"
]
},
"execution": {
"type": "string",
"enum": [
"client"
]
},
"description": {
"type": [
"string",
"null"
]
},
"parameters": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"object"
]
}
},
"required": [
"type"
]
}
},
"required": [
"type",
"execution",
"parameters"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"web_search"
]
},
"search_context_size": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"user_location": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"approximate"
]
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"timezone": {
"type": "string"
}
}
}
},
"required": [
"type"
],
"title": "Web Search Tool"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"x_search"
]
},
"allowed_x_handles": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"excluded_x_handles": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10
},
"from_date": {
"type": "string"
},
"to_date": {
"type": "string"
},
"enable_image_understanding": {
"type": "boolean"
},
"enable_video_understanding": {
"type": "boolean"
}
},
"required": [
"type"
],
"title": "X Search Tool"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"code_interpreter"
]
},
"container": {
"type": "object",
"properties": {
"image": {
"type": "string"
}
}
}
},
"required": [
"type"
],
"title": "Code Interpreter Tool"
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"file_search"
]
},
# --- truncated at 32 KB (60 KB total) ---
# Full source: https://artifacts.apis.io/venice-ai/json-schema/venice-ai-responses-request-schema.json
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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/venice-ai-responses-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.