# ZeroGPU Single-Input Inference (Text Generation, Extraction, Classification)

> ZeroGPU Single-Input Inference (Text Generation, Extraction, Classification) is a paid API for AI agents from agents.zerogpu.ai, paid per call via MPP, price unknown, status healthy (last checked 2026-10-12, last successful call 2026-10-02).

Sends a single input text to a selected ZeroGPU model and returns generated text, extracted entities/PII, or a classification label depending on the chosen model.

## Facts

- Endpoint: POST https://agents.zerogpu.ai/zeroclick/v1/responses?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-02
- Success rate: 66% of calls made through Zero
- Rating: 4.8 / 5 from 2 reviews
- Activations on Zero: 266
- Provider: agents.zerogpu.ai
- Website: https://agents.zerogpu.ai
- Canonical page: https://www.zero.xyz/c/agents-zerogpu-ai-zerogpu-single-input-inference-text-generation-65a12bf9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nZMOrINrMGaB3hLA08RMF

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 agents-zerogpu-ai-zerogpu-single-input-inference-text-generation-65a12bf9 -d '<json body>'
```

Example prompt: Use the gliner-multi-pii-v1 model to scan this text for PII across all entity types and return what you find: 'John Smith, born 12/03/1985, lives at 42 Maple Street, London, and his email is jsmith@email.com.'

## When to prefer this

Choose this endpoint when you need a single-call, single-input inference without managing a messages array — ideal for classification, extraction, or short text generation tasks. Prefer it over the chat completions endpoint when working with extraction models (gliner2-base-v1, gliner-multi-pii-v1) or classification models (deberta-v3-small, IAB taxonomy models) that don't require conversational turn history. It is especially well-suited for high-volume pipelines processing one text at a time with specialized small models optimized for edge deployment.

## Known failure modes

- Invalid or unsupported model ID returns an error status
- Empty or missing input field causes a validation error
- Instructions field provided to a classifier model is silently ignored
- Token limits exceeded for large inputs may return a failed status
- Unknown pricing or billing issues may result in a 402 Payment Required response
- Network or infrastructure errors at the edge may cause transient failures

## How this service works

OpenAI-style Responses endpoint, authenticated by verifying the
`zc-signature` HMAC over the raw request bytes. The request is routed by
`model` using model metadata, and the same orchestration as
`/v1/responses` runs behind it.

On success, actual token usage is settled with ZeroClick and reported
via the `zc-usage` response header.


## Output

An OpenAI Responses-style object containing: an output array with the model's response (generated text, extracted entity list, or classification labels), the model name, creation timestamp, status ('completed' or 'failed'), and token usage breakdown (input_tokens, output_tokens, total_tokens). On error, status is 'failed' and an error field is populated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "model",
  "input"
 ],
 "properties": {
  "text": {
   "type": "object",
   "properties": {
    "format": {
     "type": "object",
     "properties": {
      "type": {
       "enum": [
        "text"
       ],
       "type": "string",
       "description": "Output format. `text` is supported; `json` is currently rejected."
      }
     }
    }
   }
  },
  "input": {
   "type": "string",
   "description": "Prompt text. Combined with `instructions` (as a system message) to form the model input."
  },
  "model": {
   "type": "string",
   "example": "LFM2.5-1.2B-Instruct"
  },
  "store": {
   "type": "boolean",
   "default": true
  },
  "top_p": {
   "type": "number",
   "nullable": true
  },
  "metadata": {
   "type": "object",
   "description": "Up to 16 string key/value pairs echoed back in the response envelope. Also carries GLiNER usecase options (`usecase`, `schema`, `labels`, `threshold`, `mask`, `replacement_char`), which are consumed and not necessarily echoed.",
   "additionalProperties": {
    "type": "string"
   }
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Candidate labels for text-classification models."
  },
  "truncation": {
   "enum": [
    "auto",
    "disabled"
   ],
   "type": "string",
   "default": "auto"
  },
  "temperature": {
   "type": "number",
   "nullable": true
  },
  "instructions": {
   "type": "string",
   "description": "System-style instructions prepended to the input. Classification models may pass comma-separated or bracketed candidate labels here."
  },
  "multilingual": {
   "type": "boolean"
  },
  "max_output_tokens": {
   "type": "integer",
   "nullable": true
  },
  "parallel_tool_calls": {
   "type": "boolean",
   "default": true
  },
  "previous_response_id": {
   "type": "string",
   "nullable": true
  }
 },
 "additionalProperties": true
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "text": {
   "type": "object",
   "properties": {
    "format": {
     "type": "object",
     "properties": {
      "type": {
       "type": "string"
      }
     }
    }
   }
  },
  "user": {
   "type": "string",
   "nullable": true
  },
  "error": {
   "oneOf": [
    {
     "type": "null"
    },
    {
     "type": "object",
     "required": [
      "message"
     ],
     "properties": {
      "code": {
       "type": "string"
      },
      "type": {
       "type": "string"
      },
      "param": {
       "type": "string"
      },
      "message": {
       "type": "string"
      }
     },
     "description": "Error attached to a Responses envelope. OpenAI's ResponseError carries\n`code` and `message`; `type` and `param` are also emitted by some error\nsites on this endpoint.\n"
    }
   ]
  },
  "model": {
   "type": "string"
  },
  "store": {
   "type": "boolean"
  },
  "tools": {
   "type": "array",
   "items": {}
  },
  "top_p": {
   "type": "number",
   "nullable": true
  },
  "usage": {
   "type": "object",
   "nullable": true,
   "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"
      }
     }
    }
   }
  },
  "object": {
   "type": "string",
   "const": "response"
  },
  "output": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string"
     },
     "role": {
      "type": "string",
      "const": "assistant"
     },
     "type": {
      "type": "string",
      "const": "message"
     },
     "status": {
      "type": "string"
     },
     "content": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "text": {
         "type": "string"
        },
        "type": {
         "type": "string",
         "const": "output_text"
        },
        "annotations": {
         "type": "array",
         "items": {}
        }
       }
      }
     }
    }
   }
  },
  "status": {
   "enum": [
    "completed",
    "failed"
   ],
   "type": "string"
  },
  "metadata": {
   "type": "object",
   "a
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-zerogpu-ai-zerogpu-single-input-inference-text-generation-65a12bf9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.zerogpu.ai](https://www.zero.xyz/host/agents.zerogpu.ai/llms.txt)