Skip to main content
POST
Create response
One endpoint for every model. Pass text or a document as input; what comes back depends on the model: generated text, a classification, extracted fields, redacted output, and more. The input and output shapes vary by model, so open a model page for a prefilled playground. For the messages-style route, see Chat completions. Install the official SDK from npm or PyPI (pip install zerogpu-api). Source: zerogpu/SDK. Handle errors the same way as API error codes.

Authorizations

x-api-key
string
header
required

Your ZeroGPU API key. Create one in the dashboard under API keys. Send it on every request.

Headers

x-project-id
string

Optional project identifier. Scopes the request to a specific project when provided.

Body

application/json
model
enum<string>
required

Model identifier. Open a model page for a dedicated playground with the correct body for that model.

Available options:
llama-3.1-8b-instruct-fast,
LFM2.5-1.2B-Instruct,
LFM2.5-1.2B-Thinking,
gpt-oss-120b,
deberta-v3-small,
gliner2-base-v1,
gliner-multi-pii-v1,
zlm-v1-followup-questions-edge,
zlm-v1-iab-classify-edge,
zlm-v2-iab-classify-edge-enriched,
zlm-v1-iab-domain-classifier
Example:

"llama-3.1-8b-instruct-fast"

input
string<textarea>
required

The text or document to send, as a plain string.

Required string length: 1 - 131072
text
object

Response format configuration.

instructions
string

Optional system-style instructions applied on top of input, for models that support them.

metadata
object

Optional model-specific parameters, passed through to the model. For example, PII models accept mask and usecase. See the relevant model page for supported keys.

Response

Success

The generated model response.

id
string

Unique identifier for the response.

Example:

"resp_abc123"

object
string

Object type. Always response.

Example:

"response"

created
integer

Unix timestamp (seconds) when the response was created.

Example:

1710000000

model
string

The model used for inference.

Example:

"llama-3.1-8b-instruct-fast"

output
object[]

Output message objects produced by the model.

usage
object

Token usage statistics for the request.