# Venice AI Responses API

> Venice AI Responses API is a paid API for AI agents from api.venice.ai, paid per call via x402, $10/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: POST https://api.venice.ai/api/v1/responses
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/venice-ai-responses-api-b52385ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZEP9RVnpybrT15B5njKd6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability venice-ai-responses-api-b52385ff -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

OpenAI-compatible Responses API (alpha).

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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"
                  }
                 }
                }
               }
              },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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_
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/venice-ai-responses-api-b52385ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.venice.ai](https://www.zero.xyz/host/api.venice.ai/llms.txt)