{"uid":"cap_ZEP9RVnpybrT15B5njKd6","slug":"venice-ai-responses-api-b52385ff","name":"Venice AI Responses API","description":"OpenAI-compatible Responses API (alpha).","url":"https://api.venice.ai/api/v1/responses","method":"POST","headers":{},"bodySchema":{"type":"object","title":"Responses API Request","required":["model","input"],"properties":{"input":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"type":"object","title":"Input Message","required":["type","role","content"],"properties":{"id":{"type":"string"},"role":{"enum":["user","assistant","system","developer"],"type":"string"},"type":{"enum":["message"],"type":"string"},"status":{"enum":["completed","in_progress"],"type":"string"},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"oneOf":[{"type":"object","title":"Input Text","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["input_text"],"type":"string"}}},{"type":"object","title":"Input Image","required":["type","image_url"],"properties":{"type":{"enum":["input_image"],"type":"string"},"image_url":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"detail":{"enum":["auto","low","high"],"type":"string"}}}}},{"type":"object","title":"Output Text (for history)","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["output_text"],"type":"string"},"annotations":{"type":"array","items":{"nullable":true}}}}]}}]}}},{"type":"object","title":"Input Message (Flexible)","required":["role","content"],"properties":{"id":{"type":"string"},"role":{"enum":["user","assistant","system","developer"],"type":"string"},"status":{"enum":["completed","in_progress"],"type":"string"},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"anyOf":[{"oneOf":[{"type":"object","title":"Input Text","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["input_text"],"type":"string"}}},{"type":"object","title":"Input Image","required":["type","image_url"],"properties":{"type":{"enum":["input_image"],"type":"string"},"image_url":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"detail":{"enum":["auto","low","high"],"type":"string"}}}}},{"type":"object","title":"Output Text (for history)","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["output_text"],"type":"string"},"annotations":{"type":"array","items":{"nullable":true}}}}]},{"type":"object","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["text"],"type":"string"}}},{"type":"object","required":["type","image_url"],"properties":{"type":{"enum":["image_url"],"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"detail":{"enum":["auto","low","high"],"type":"string"}}}]}}}]}}]}}},{"type":"object","title":"Reasoning","required":["type"],"properties":{"id":{"type":"string","nullable":true},"type":{"enum":["reasoning"],"type":"string"},"status":{"enum":["completed","in_progress"],"type":"string","nullable":true},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"nullable":true}},{"title":"null","nullable":true},{"title":"null","nullable":true}]},"summary":{"type":"array","items":{"type":"string"},"nullable":true},"encrypted_content":{"type":"string","nullable":true}}},{"type":"object","title":"Function Call","required":["type","call_id","name","arguments"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"enum":["function_call"],"type":"string"},"status":{"enum":["completed","in_progress"],"type":"string"},"call_id":{"type":"string"},"arguments":{"type":"string"}}},{"type":"object","title":"Function Call Output","required":["type","call_id","output"],"properties":{"type":{"enum":["function_call_output"],"type":"string"},"output":{"anyOf":[{"type":"string"},{"type":"array","items":{"nullable":true}},{"type":"object","additionalProperties":{"nullable":true}},{"type":"number"},{"type":"boolean"},{"title":"null","nullable":true},{"title":"null","nullable":true}]},"call_id":{"type":"string"}}},{"type":"object","title":"Item Reference","required":["type","id"],"properties":{"id":{"type":"string"},"type":{"enum":["item_reference"],"type":"string"}}}]}}],"description":"The input to generate a response for. Can be a simple string or an array of messages."},"model":{"type":"string","example":"zai-org-glm-5-1","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."},"tools":{"type":"array","items":{"anyOf":[{"type":"object","title":"Function Tool","required":["type","function"],"properties":{"type":{"enum":["function"],"type":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"The name of the function to call."},"strict":{"type":"boolean"},"parameters":{"type":"object","additionalProperties":{"nullable":true}},"description":{"type":"string"}},"description":"The function definition exposed to the model, including its name and parameters."}}},{"type":"object","title":"Web Search Tool","required":["type"],"properties":{"type":{"enum":["web_search"],"type":"string"},"user_location":{"type":"object","properties":{"city":{"type":"string"},"type":{"enum":["approximate"],"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string"}}},"search_context_size":{"enum":["low","medium","high"],"type":"string"}}},{"type":"object","title":"X Search Tool","required":["type"],"properties":{"type":{"enum":["x_search"],"type":"string"},"to_date":{"type":"string"},"from_date":{"type":"string"},"allowed_x_handles":{"type":"array","items":{"type":"string"},"maxItems":10},"excluded_x_handles":{"type":"array","items":{"type":"string"},"maxItems":10},"enable_image_understanding":{"type":"boolean"},"enable_video_understanding":{"type":"boolean"}}},{"type":"object","title":"Code Interpreter Tool","required":["type"],"properties":{"type":{"enum":["code_interpreter"],"type":"string"},"container":{"type":"object","properties":{"image":{"type":"string"}}}}},{"type":"object","title":"File Search Tool","required":["type"],"properties":{"type":{"enum":["file_search"],"type":"string"},"max_num_results":{"type":"integer"},"ranking_options":{"type":"object","properties":{"ranker":{"type":"string"},"score_threshold":{"type":"number"}}},"vector_store_ids":{"type":"array","items":{"type":"string"}}}},{"type":"object","title":"Computer Use Tool","required":["type"],"properties":{"type":{"enum":["computer_use_preview"],"type":"string"},"environment":{"type":"string"},"display_width":{"type":"integer"},"display_height":{"type":"integer"}}},{"type":"object","title":"Generic Tool","required":["type"],"properties":{"type":{"type":"string","description":"The tool type (e.g. `function`)."}}}],"title":"Tool Definition"},"description":"A list of tools the model may call."},"top_p":{"type":"number","maximum":1,"minimum":0,"description":"Nucleus sampling parameter."},"stream":{"type":"boolean","description":"Whether to stream back partial progress."},"include":{"type":"array","items":{"type":"string"},"description":"Additional response fields to include (OpenAI-compatible)."},"reasoning":{"type":"object","title":"Reasoning Configuration","nullable":true,"properties":{"effort":{"enum":["none","minimal","low","medium","high","xhigh","max"],"type":"string","description":"Controls reasoning effort level for supported models."},"summary":{"enum":["auto","concise","detailed"],"type":"string","description":"Controls reasoning summary format."}}},"web_search":{"type":"boolean","description":"Enable web search for this request."},"temperature":{"type":"number","maximum":2,"minimum":0,"description":"Sampling temperature between 0 and 2."},"tool_choice":{"anyOf":[{"enum":["auto"],"type":"string"},{"enum":["none"],"type":"string"},{"enum":["required"],"type":"string"},{"type":"object","required":["type","function"],"properties":{"type":{"enum":["function"],"type":"string"},"function":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"The name of the function to call."}},"description":"The specific function the model should call."}}}],"description":"Controls which tool is called by the model."},"max_output_tokens":{"type":"integer","minimum":0,"description":"Maximum number of tokens to generate.","exclusiveMinimum":true},"venice_parameters":{"type":"object","title":"Venice Parameters","properties":{"enable_e2ee":{"type":"boolean","description":"Enable end-to-end encryption for E2EE-capable models. When true (default), E2EE is used if headers are present. When false, TEE-only mode is used."},"character_slug":{"type":"string","description":"The character slug of a public Venice character."},"enable_web_search":{"enum":["auto","off","on"],"type":"string","description":"Enable web search for this request."},"enable_web_scraping":{"type":"boolean","description":"Enable Venice web scraping of URLs in the latest user message."},"enable_web_citations":{"type":"boolean","description":"Request that the LLM cite its sources."},"include_venice_system_prompt":{"type":"boolean","description":"Whether to include the Venice supplied system prompts."},"include_search_results_in_stream":{"type":"boolean","description":"Include search results in the stream as the first emitted chunk."}}}},"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."},"responseSchema":{"type":"object","title":"Responses API Response","required":["id","object","created_at","model","status","output"],"properties":{"id":{"type":"string","example":"resp_abc123","description":"Unique identifier for the response."},"error":{"type":"object","title":"Error","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"description":"Error information if the response failed."},"model":{"type":"string","description":"The model used for the response."},"usage":{"type":"object","title":"Usage","required":["input_tokens","output_tokens","total_tokens"],"properties":{"input_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"input_tokens_details":{"type":"object","properties":{"cached_tokens":{"type":"integer"}}},"output_tokens_details":{"type":"object","properties":{"reasoning_tokens":{"type":"integer"}}}},"description":"Token usage statistics."},"object":{"enum":["response"],"type":"string","description":"The object type."},"output":{"type":"array","items":{"anyOf":[{"type":"object","title":"Reasoning Output","required":["type","id"],"properties":{"id":{"type":"string"},"type":{"enum":["reasoning"],"type":"string"},"summary":{"type":"array","items":{"type":"string"}},"encrypted_content":{"type":"string"}}},{"type":"object","title":"Message Output","required":["type","id","status","role","content"],"properties":{"id":{"type":"string"},"role":{"enum":["assistant"],"type":"string"},"type":{"enum":["message"],"type":"string"},"status":{"enum":["completed","in_progress","failed"],"type":"string"},"content":{"type":"array","items":{"type":"object","title":"Output Text","required":["type","text"],"properties":{"text":{"type":"string"},"type":{"enum":["output_text"],"type":"string"},"annotations":{"type":"array","items":{"type":"object","title":"URL Citation Annotation","required":["type","url","start_index","end_index"],"properties":{"url":{"type":"string"},"type":{"enum":["url_citation"],"type":"string"},"title":{"type":"string"},"end_index":{"type":"integer"},"start_index":{"type":"integer"}}}}}}}}},{"type":"object","title":"Function Call Output","required":["type","id","call_id","name","arguments","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"enum":["function_call"],"type":"string"},"status":{"enum":["completed","in_progress"],"type":"string"},"call_id":{"type":"string"},"arguments":{"type":"string"}}},{"type":"object","title":"Web Search Call Output","required":["type","id","status"],"properties":{"id":{"type":"string"},"type":{"enum":["web_search_call"],"type":"string"},"status":{"enum":["completed"],"type":"string"}}}]},"description":"The output items generated by the model."},"status":{"enum":["completed","failed","in_progress","cancelled"],"type":"string","description":"The status of the response."},"created_at":{"type":"integer","description":"Unix timestamp of when the response was created."}},"description":"Response from the Responses API endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ECjewMwshrIPEbw7qkKm6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a structured model response using the OpenAI-compatible Responses API format, returning typed output blocks including reasoning, messages, function calls, and web search results.","exampleAgentPrompt":"Using Venice AI's Responses API with model 'venice-llama-3.3-70b', respond to this conversation: system says 'You are a helpful assistant', user asks 'What are the top 3 causes of climate change?' and stream the response back to me.","exampleUseCases":null,"resultDescription":"Returns a structured response object with a unique response ID, model name, status, and an output array containing typed blocks: reasoning blocks (thought chains from reasoning models), message blocks (assistant text with URL citation annotations), function call blocks, and web search result blocks. Also includes token usage statistics (input, output, total tokens, cached tokens, reasoning tokens).","failureModes":["E2EE-capable model used — endpoint does not support E2EE models, returns error directing to /api/v1/chat/completions","Invalid or missing model identifier returns 400 error","Malformed input schema (missing required 'model' or 'input' fields) returns validation error","Authentication failure (missing or invalid Bearer token) returns 401","Rate limit exceeded returns 429 with rate limit details","Alpha access restriction — endpoint only available to Alpha testers, returns 403 for non-alpha users","Streaming connection dropped mid-response"],"whenToPreferThis":"Choose this endpoint when you need structured, typed output blocks from Venice AI models — particularly when you want to capture reasoning chains from reasoning models alongside the main response, or when you need function call outputs and web search results in a clearly typed format. Prefer this over /api/v1/chat/completions when the Responses API typed block structure is valuable for downstream parsing, or when you are migrating from OpenAI's Responses API. Use /api/v1/chat/completions instead if you need E2EE model support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:14.079Z","isFirstParty":false}