Responses

POST /v1/responses

Generate a model response using the Responses API format. Supports instructions, multi-turn via previous_response_id, tools, and streaming.

Headers

Request body

Required fields

Optional fields

Input format

The input field accepts either a plain string or an array of input items:

// Simple string
{"input": "What is the capital of France?"}

// Array of items
{"input": [
  {"role": "user", "content": "What is the capital of France?"}
]}

Examples

curl -X POST https://api.quantized.us/v1/responses \
  -H "Authorization: Bearer sk-quantized-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "input": "What is the capital of France?",
    "instructions": "You are a geography expert. Be concise.",
    "max_output_tokens": 128
  }'

import httpx

response = httpx.post(
    "https://api.quantized.us/v1/responses",
    headers={"Authorization": "Bearer sk-quantized-YOUR-KEY"},
    json={
        "model": "openai/gpt-4.1-mini",
        "input": "What is the capital of France?",
        "instructions": "You are a geography expert. Be concise.",
        "max_output_tokens": 128,
    },
)
data = response.json()
print(data["output"][0]["content"][0]["text"])

from openai import OpenAI

client = OpenAI(
    api_key="sk-quantized-YOUR-KEY",
    base_url="https://api.quantized.us/v1",
)

response = client.responses.create(
    model="openai/gpt-4.1-mini",
    input="What is the capital of France?",
    instructions="You are a geography expert. Be concise.",
    max_output_tokens=128,
)
print(response.output[0].content[0].text)

Response

{
  "id": "resp-abc123",
  "object": "response",
  "status": "completed",
  "model": "openai/gpt-4.1-mini",
  "output": [
    {
      "id": "msg-001",
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "The capital of France is Paris."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 8,
    "total_tokens": 28,
    "credits_used": 2000,
    "credits_remaining": 998000,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  },
  "created_at": 1719000000
}

Response fields

Streaming

Set "stream": true to receive Server-Sent Events. The Responses endpoint uses typed events (response.created, response.output_text.delta, response.completed, etc.). See the Streaming guide for the full event format and code examples.

Errors