# Responses API (beta)

Use Laminarity's stateless OpenAI Responses-compatible subset for basic response and tool flows.

> Verification: contract-tested; checked 2026-09-01; OpenAI Python SDK, Laminarity public OpenAPI 3.1

## Create a response

The beta Responses endpoint is a stateless translation layer over Laminarity's Chat Completions orchestration. It accepts a string or compatible item list as `input`. `instructions` becomes the developer message, and `model: "auto"` retains Laminarity selection and fallback.

```bash
curl https://api.laminarity.ai/v1/responses \
  -H "Authorization: Bearer $LAMINARITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "instructions": "Answer concisely.",
    "input": "Give me one launch checklist item."
  }'
```

## Use the OpenAI SDK

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAMINARITY_API_KEY"],
    base_url="https://api.laminarity.ai/v1",
)

response = client.responses.create(
    model="auto",
    instructions="Answer concisely.",
    input="Give me one launch checklist item.",
)
print(response.output_text)
```

## Stream typed events

Set `stream: true` to receive Responses-style server-sent events. Text streams emit `response.created`, one or more `response.output_text.delta` events, and `response.completed`. Tool arguments use `response.function_call_arguments.delta`; failures use an `error` event.

## Replay tool results

Function tools are supported. Send the returned `function_call` item and a matching `function_call_output` item in the next request's `input` list.

`previous_response_id` is not supported because Laminarity does not persist response state; `store` is accepted for compatibility but does not add persistence. Replay prior output items explicitly instead. Built-in hosted tools and full reasoning continuity are not part of the current subset.

The streaming lifecycle is intentionally smaller than the full OpenAI API. Unknown top-level fields are ignored, so a successful request does not prove an unsupported feature was executed.

> Note: Chat Completions remains the recommended default for agents and broad OpenAI-compatible clients. The Responses subset shares the same project restrictions, `auto` behavior, price controls, and fallback rules.

## Upstream documentation

- [OpenAI Responses API reference](https://platform.openai.com/docs/api-reference/responses)