EmpirioLabs AI Chat Completions API

openapi: 3.2.0
info:
  title: Reference Chat Completions API
  version: 1.0.0
tags:
- name: chatCompletions
paths:
  /v1/chat/completions:
    post:
      operationId: chatCompletions_createChatCompletion
      summary: Create a chat completion
      description: 'OpenAI-compatible chat completions. Pass any chat-capable model

        from the catalog as `model`. Supports streaming (SSE), tool

        calling, vision input, audio input, JSON mode, structured

        output, and provider-specific reasoning controls.


        Streaming uses Server-Sent Events with `data: ...` lines and a

        final `data: [DONE]`.

        `usage` arrives at the end of the stream on a chunk that also has

        `choices`. Set `stream_options.include_usage` to `true` to receive it

        the way OpenAI sends it, in its own chunk just before `[DONE]` whose

        `choices` is an empty list; some models still report it on a chunk

        with `choices`. Read `usage` from the last chunk that carries it.'
      tags:
      - chatCompletions
      responses:
        '200':
          description: Completion (or SSE stream when `stream=true`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatResponse'
        '400':
          description: Invalid request; see error message for the offending parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: The account cannot cover the pay-as-you-go amount required by the request. An active plan can run a request at zero balance only when the entire request is covered by remaining allowance. Partly covered requests require enough balance for the full remainder before work starts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded for this API key. Retry with backoff.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatRequest'
      security:
      - bearerAuth: []
components:
  schemas:
    Message:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            param:
              type: string
            code:
              type: string
    ChatResponse:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        created:
          type: integer
        model:
          type: string
        choices:
          type: array
          items:
            $ref: '#/components/schemas/Choice'
    ChatRequest:
      type: object
      properties:
        model:
          type: string
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
    Choice:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT