---
title: "Create response"
method: POST
path: "/responses"
tags: ["Responses"]
---

# Create response

`POST /responses`

## Headers

- `x-project-id` string

## Request body

- CreateResponseRequest
  - `model` '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', required — Model identifier. Open a [model page](/api-reference/models) for a dedicated playground with the correct body for that model.
  - `input` string, textarea, required — The text or document to send, as a plain string.
  - `text` object — Response format configuration.
    - `format` object
      - `type` string — Output format for the response, for example `text`.
  - `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](/api-reference/models) for supported keys.

## Response `200`

Success

- Response — The generated model response.
  - `id` string — Unique identifier for the response.
  - `object` string — Object type. Always `response`.
  - `created` integer — Unix timestamp (seconds) when the response was created.
  - `model` string — The model used for inference.
  - `output` OutputMessage[] — Output message objects produced by the model.
    - `type` string — Output item type.
    - `role` string — Author of the output. Always `assistant`.
    - `content` object[] — Content parts that make up the message.
      - `type` string — Content part type.
      - `text` string — The generated text.
  - `usage` Usage — Token usage statistics for the request.
    - `input_tokens` integer — Number of tokens in the input.
    - `output_tokens` integer — Number of tokens generated.
    - `total_tokens` integer — Total tokens consumed (input plus output).

## Other responses

- `400` — Bad request (invalid body)
- `401` — Unauthorized (invalid or missing API key)
- `403` — Forbidden (invalid project ID or permissions)
- `420` — Insufficient quota (insufficient_quota)
- `500` — Internal server error

---

[API](https://skmtc.dev/zerogpu/apis/zerogpu-batch-files-api.md) · [All operations](https://skmtc.dev/zerogpu/apis/zerogpu-batch-files-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerogpu/zerogpu-batch-files-api/revisions/f7371035d1a2/schema)