Skip to main content
POST /v1/responses accepts a string or structured input and returns typed output items instead of a messages array. Auriko routes these requests across providers, and routing features (multi-model, cost optimization, and extensions) work with both endpoints. If you’re building with the OpenAI SDK’s client.responses.create(), use this endpoint.
The Response API is in preview. The interface may change before GA.

Prerequisites

  • An Auriko API key
  • Python 3.10+ with the OpenAI SDK (pip install openai) or the Auriko SDK (pip install auriko)
    • OR Node.js 18+ with the OpenAI SDK (npm install openai) or @auriko/sdk (npm install @auriko/sdk)

Send requests

Send a request and read the output text:

Check model support

Chat models work with both /v1/chat/completions and /v1/responses. Some models are only available via the Response API — OpenAI pro-tier models such as gpt-5.5-pro and o3-pro — and chat-format requests to them return response_api_only. To check endpoint support for a model, read supported_endpoints on each provider entry in the model directory, or list every Response-API-callable model directly:

Map parameters

If you’re migrating existing Chat Completions code, use this table to translate parameter names:

Check feature support

Resources

Streaming

Stream events as they’re generated

Tool Calling

Call functions with the input/output item format

Structured Output

Constrain output to a JSON Schema

Reasoning

Control reasoning effort and access summaries

Routing and Extensions

Multi-model routing and provider extensions

API Reference

Full endpoint specification

Python SDK

Python SDK reference for responses

TypeScript SDK

TypeScript SDK reference for responses