> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetokenless.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses

> Tokenless accepts the compatible Responses API request shape and routes
the request behind a Tokenless routing profile. For the complete
upstream contract, see the [OpenAI API reference](https://developers.openai.com/api/reference/overview).


<div className="endpoint-signature"><span className="endpoint-method endpoint-method-post">POST</span><code>/openai/v1/responses</code></div>

For the full upstream contract, see the [OpenAI API reference](https://developers.openai.com/api/reference/overview).

<RequestExample>
  ```bash cURL
  curl https://api.usetokenless.com/openai/v1/responses \
    -H "Authorization: Bearer $TOKENLESS_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "tokenless-pro",
      "input": "Explain model routing in one paragraph.",
      "stream": true
    }'
  ```
</RequestExample>

<ResponseExample>
  ```sse Stream (abridged)
  event: response.created
  data: {"type":"response.created","sequence_number":0,"response":{"id":"resp_req_1e6255bf_5d10049d4ab0_1","object":"response","created_at":0,"model":"tokenless-pro","status":"in_progress","output":[]}}

  event: response.output_item.added
  data: {"type":"response.output_item.added","sequence_number":2,"output_index":0,"item":{"id":"msg_req_1e6255bf_5d10049d4ab0_1","type":"message","role":"assistant","content":[],"status":"in_progress"}}

  event: response.output_text.delta
  data: {"type":"response.output_text.delta","sequence_number":3,"item_id":"msg_req_1e6255bf_5d10049d4ab0_1","output_index":0,"content_index":0,"delta":"Model routing is the process of directing a request to the most suitable model…"}

  event: response.output_item.done
  data: {"type":"response.output_item.done","sequence_number":5,"output_index":0,"item":{"id":"msg_req_1e6255bf_5d10049d4ab0_1","type":"message","role":"assistant","content":[{"type":"output_text","text":"Model routing is the process of directing a request to the most suitable model…"}],"status":"completed"}}

  event: response.completed
  data: {"type":"response.completed","sequence_number":6,"response":{"id":"resp_req_1e6255bf_5d10049d4ab0_1","object":"response","created_at":0,"model":"tokenless-pro","status":"completed","output":[{"id":"msg_req_1e6255bf_5d10049d4ab0_1","type":"message","role":"assistant","content":[{"type":"output_text","text":"Model routing is the process of directing a request to the most suitable model…"}],"status":"completed"}],"usage":{"input_tokens":11,"output_tokens":227,"total_tokens":238}}}
  ```
</ResponseExample>


## OpenAPI

````yaml /openapi/compatibility.yaml post /openai/v1/responses
openapi: 3.1.0
info:
  title: Tokenless Compatibility and BYOK API
  version: 1.0.0
  description: |
    OpenAI- and Anthropic-compatible routing endpoints, plus interactive-session
    management for bring-your-own provider keys.
servers:
  - url: https://api.usetokenless.com
security:
  - tokenlessBearer: []
paths:
  /openai/v1/responses:
    post:
      tags:
        - OpenAI
      summary: Responses
      description: >
        Tokenless accepts the compatible Responses API request shape and routes

        the request behind a Tokenless routing profile. For the complete

        upstream contract, see the [OpenAI API
        reference](https://developers.openai.com/api/reference/overview).
      operationId: createResponse
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAIResponsesRequest'
      responses:
        '200':
          description: An OpenAI-compatible response or SSE stream.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestID'
        '400':
          $ref: '#/components/responses/OpenAIError'
        '401':
          $ref: '#/components/responses/OpenAIError'
        '402':
          $ref: '#/components/responses/OpenAIError'
components:
  schemas:
    OpenAIResponsesRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          $ref: '#/components/schemas/RoutingProfile'
        input:
          description: Text or structured Responses API input.
          oneOf:
            - type: string
            - type: array
              items: {}
        stream:
          type: boolean
          default: false
      additionalProperties: true
    RoutingProfile:
      type: string
      enum:
        - tokenless-pro
        - tokenless-max
        - tokenless-ultra-saver
    OpenAIError:
      type: object
      properties:
        error:
          type: object
          additionalProperties: true
  headers:
    RequestID:
      description: Identifier for the routed request. Save it for support and usage lookup.
      schema:
        type: string
  responses:
    OpenAIError:
      description: OpenAI-compatible error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/OpenAIError'
  securitySchemes:
    tokenlessBearer:
      type: http
      scheme: bearer
      bearerFormat: Tokenless API key

````