# Responses

OpenAI Responses text facade.

`POST /api/v1/responses`

## Overview

Converts string or input_text Responses requests to the native OpenAI-compatible relay. Streaming output events are supported; built-in tools and stateful items are not supported.

## Parameters

- `model` (string) — required: Model ID that supports the Responses API.
- `input` (string) — required: Prompt or structured input items.
- `stream` (boolean): Stream incremental output events.

## Example

```bash
curl -X POST https://capi.ai/api/v1/responses \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Draft a migration plan"
  }'
```

## Response

```json
{
  "id": "resp_5c81a2",
  "object": "response",
  "model": "gpt-5.6-sol",
  "output": [
    { "type": "message", "role": "assistant", "content": [] }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 402 }
}
```