openapi: 3.1.0
info:
  title: TexAPI
  version: 2.0.0
  description: 'TexAPI API gateway — one key for every model on sale, over OpenAI
    Chat Completions, OpenAI Responses, Anthropic Messages and Google Gemini formats.


    ## Authentication


    All API requests require an API key passed in the `Authorization` header:


    ```

    Authorization: Bearer sk-texapi-...

    ```


    ## Base URL


    ```

    https://api.texapi.dev

    ```

    '
  contact:
    name: TexAPI Support
    url: https://texapi.dev
  license:
    name: Proprietary
servers:
- url: https://api.texapi.dev
  description: Production server
security:
- BearerAuth: []
tags:
- name: Chat
  description: OpenAI-compatible chat completions
- name: Messages
  description: Anthropic-compatible messages API
- name: Responses
  description: OpenAI Responses API
- name: Gemini
  description: Google Gemini API
- name: Images
  description: Image generation and editing
- name: Models
  description: List and retrieve model information
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key with `sk-texapi-` prefix
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - invalid_request
              - authentication_failed
              - rate_limit_exceeded
              - insufficient_funds
              - unsupported_streaming
              - model_not_found
              - upstream_error
              - internal_error
            message:
              type: string
              description: Human-readable error message
    ChatMessage:
      type: object
      required:
      - role
      - content
      properties:
        role:
          type: string
          enum:
          - system
          - user
          - assistant
          - tool
        content:
          oneOf:
          - type: string
          - type: array
            items:
              type: object
        name:
          type: string
        tool_calls:
          type: array
          items:
            type: object
        tool_call_id:
          type: string
    ChatCompletionRequest:
      type: object
      required:
      - model
      - messages
      properties:
        model:
          type: string
          description: Model ID (e.g., `deepseek-v4-pro`)
        messages:
          type: array
          items:
            $ref: '#/components/schemas/ChatMessage'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 1000000
        temperature:
          type: number
          minimum: 0
          maximum: 2
        top_p:
          type: number
          minimum: 0
          maximum: 1
        n:
          type: integer
          minimum: 1
          default: 1
        stream:
          type: boolean
          default: false
        stop:
          oneOf:
          - type: string
          - type: array
            items:
              type: string
        presence_penalty:
          type: number
          minimum: -2
          maximum: 2
        frequency_penalty:
          type: number
          minimum: -2
          maximum: 2
        logit_bias:
          type: object
          additionalProperties:
            type: number
        user:
          type: string
        tools:
          type: array
          items:
            type: object
        tool_choice:
          oneOf:
          - type: string
          - type: object
        response_format:
          type: object
          properties:
            type:
              type: string
              enum:
              - text
              - json_object
              - json_schema
        seed:
          type: integer
        logprobs:
          type: boolean
    ChatCompletionResponse:
      type: object
      required:
      - id
      - object
      - created
      - model
      - choices
      properties:
        id:
          type: string
        object:
          type: string
          enum:
          - chat.completion
        created:
          type: integer
        model:
          type: string
        choices:
          type: array
          items:
            type: object
            required:
            - index
            - message
            - finish_reason
            properties:
              index:
                type: integer
              message:
                $ref: '#/components/schemas/ChatMessage'
              finish_reason:
                type: string
                enum:
                - stop
                - length
                - tool_calls
                - content_filter
              logprobs:
                type: object
                nullable: true
        usage:
          type: object
          required:
          - prompt_tokens
          - completion_tokens
          - total_tokens
          properties:
            prompt_tokens:
              type: integer
            completion_tokens:
              type: integer
            total_tokens:
              type: integer
            cached_tokens:
              type: integer
            cache_creation_tokens:
              type: integer
            cost_usd:
              type: number
              format: double
              description: Canonical settled USD amount charged for this request, rounded up to micro-USD before any credit conversion. Retained for backwards compatibility and billing reconciliation on non-streaming JSON responses.
            cost_credits:
              type: number
              format: double
              description: Additive display amount for settled non-streaming JSON responses, derived after settlement as cost_usd × 100 at the fixed rate 100 credits = 1 USD. Canonical accounting and reconciliation remain in cost_usd; 1 micro-USD = 0.0001 credit.
        texapi:
          $ref: '#/components/schemas/TexapiMetadata'
    TexapiCost:
      type: object
      description: Settled TexAPI request cost. Streaming SSE responses cannot include a final settled cost before the stream closes; query usage logs for that charge.
      properties:
        cost_usd:
          type: number
          format: double
          description: Canonical USD amount charged for billing and reconciliation.
        cost_credits:
          type: number
          format: double
          description: Additive display amount derived as cost_usd × 100 after settlement.
    TexapiMetadata:
      type: object
      properties:
        request_id:
          type: string
        gateway_latency_ms:
          type: number
        total_latency_ms:
          type: number
        credits_per_usd:
          type: number
          const: 100
          description: Fixed display conversion rate.
    AnthropicMessage:
      type: object
      required:
      - role
      - content
      properties:
        role:
          type: string
          enum:
          - user
          - assistant
        content:
          oneOf:
          - type: string
          - type: array
            items:
              type: object
    AnthropicMessagesRequest:
      type: object
      required:
      - model
      - messages
      - max_tokens
      properties:
        model:
          type: string
        messages:
          type: array
          items:
            $ref: '#/components/schemas/AnthropicMessage'
        max_tokens:
          type: integer
          minimum: 1
          maximum: 1000000
        system:
          oneOf:
          - type: string
          - type: array
            items:
              type: object
        temperature:
          type: number
          minimum: 0
          maximum: 1
        top_p:
          type: number
        top_k:
          type: integer
        stop_sequences:
          type: array
          items:
            type: string
        stream:
          type: boolean
          default: false
        tools:
          type: array
          items:
            type: object
        tool_choice:
          type: object
        metadata:
          type: object
    AnthropicMessagesResponse:
      type: object
      required:
      - id
      - type
      - role
      - content
      - model
      - stop_reason
      - usage
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - message
        role:
          type: string
          enum:
          - assistant
        content:
          type: array
          items:
            type: object
        model:
          type: string
        stop_reason:
          type: string
          enum:
          - end_turn
          - max_tokens
          - stop_sequence
          - tool_use
          nullable: true
        stop_sequence:
          type: string
          nullable: true
        usage:
          type: object
          required:
          - input_tokens
          - output_tokens
          properties:
            input_tokens:
              type: integer
            output_tokens:
              type: integer
            cache_creation_input_tokens:
              type: integer
            cache_read_input_tokens:
              type: integer
            cost_usd:
              type: number
              format: double
              description: Canonical USD amount charged for this non-streaming request.
            cost_credits:
              type: number
              format: double
              description: Display credits derived after settlement as cost_usd × 100.
        texapi:
          $ref: '#/components/schemas/TexapiMetadata'
    Model:
      type: object
      required:
      - id
      - display_name
      - family
      - endpoint_types
      - pricing
      properties:
        id:
          type: string
          description: Model identifier
        display_name:
          type: string
          description: Human-readable model name
        family:
          type: string
          description: Model family (e.g., `deepseek`, `qwen`, `glm`)
        endpoint_types:
          type: array
          items:
            type: string
            enum:
            - chat
            - messages
            - responses
            - generateContent
          description: Supported API formats
        pricing:
          type: object
          required:
          - input
          - output
          properties:
            input:
              type: number
              format: double
              description: Price per 1M input tokens (USD)
            output:
              type: number
              format: double
              description: Price per 1M output tokens (USD)
            cached_input:
              type: number
              format: double
              description: Price per 1M cached input tokens (USD)
            per_image:
              type: number
              format: double
              description: Price per image (USD)
        pricing_type:
          type: string
          enum:
          - token
          - image
          - token_image
    ModelsListResponse:
      type: object
      required:
      - object
      - models
      properties:
        object:
          type: string
          enum:
          - list
        models:
          type: array
          items:
            $ref: '#/components/schemas/Model'
paths:
  /v1/chat/completions:
    post:
      tags:
      - Chat
      summary: Create chat completion
      description: 'OpenAI-compatible chat completions endpoint. Supports streaming and non-streaming responses.


        Models that advertise `endpoint_types: ["chat"]` are accessible via this endpoint.

        '
      operationId: createChatCompletion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatCompletionRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatCompletionResponse'
            text/event-stream:
              schema:
                type: string
                description: Server-sent events stream
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Insufficient funds
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Upstream error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/messages:
    post:
      tags:
      - Messages
      summary: Create message (Anthropic format)
      description: 'Anthropic-compatible messages endpoint. Supports streaming via SSE.


        Models that advertise `endpoint_types: ["messages"]` are accessible via this endpoint.

        '
      operationId: createMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnthropicMessagesRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnthropicMessagesResponse'
            text/event-stream:
              schema:
                type: string
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Insufficient funds
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/responses:
    post:
      tags:
      - Responses
      summary: Create response (OpenAI Responses format)
      description: OpenAI Responses API format
      operationId: createResponse
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - model
              properties:
                model:
                  type: string
                input:
                  oneOf:
                  - type: string
                  - type: array
                messages:
                  type: array
                stream:
                  type: boolean
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    $ref: '#/components/schemas/TexapiCost'
                  texapi:
                    $ref: '#/components/schemas/TexapiMetadata'
            text/event-stream:
              schema:
                type: string
  /v1/models:
    get:
      tags:
      - Models
      summary: List available models
      description: 'Returns a list of all available models with their pricing and capabilities.


        This endpoint does not require authentication.

        '
      operationId: listModels
      security: []
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelsListResponse'
  /v1/images/generations:
    post:
      tags:
      - Images
      summary: Generate image
      description: Generate images from text prompts
      operationId: createImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - model
              - prompt
              properties:
                model:
                  type: string
                  description: Image model ID
                prompt:
                  type: string
                  description: Text description of the image
                n:
                  type: integer
                  minimum: 1
                  maximum: 1
                  default: 1
                  description: Number of images (currently only 1 supported)
                size:
                  type: string
                  description: Image dimensions
                quality:
                  type: string
                  enum:
                  - standard
                  - hd
                style:
                  type: string
                response_format:
                  type: string
                  enum:
                  - url
                  - b64_json
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                required:
                - created
                - data
                properties:
                  created:
                    type: integer
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        b64_json:
                          type: string
                  usage:
                    $ref: '#/components/schemas/TexapiCost'
                  texapi:
                    $ref: '#/components/schemas/TexapiMetadata'
  /v1/images/edits:
    post:
      tags:
      - Images
      summary: Edit image
      description: Modify images using prompts
      operationId: createImageEdit
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
              - model
              - image
              - prompt
              properties:
                model:
                  type: string
                image:
                  type: string
                  format: binary
                mask:
                  type: string
                  format: binary
                prompt:
                  type: string
                n:
                  type: integer
                size:
                  type: string
                response_format:
                  type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    $ref: '#/components/schemas/TexapiCost'
                  texapi:
                    $ref: '#/components/schemas/TexapiMetadata'
  /v1beta/models/{model}:generateContent:
    post:
      tags:
      - Gemini
      summary: Generate content (Gemini format)
      description: Google Gemini API format for content generation
      operationId: geminiGenerateContent
      parameters:
      - name: model
        in: path
        required: true
        schema:
          type: string
        description: Model path (e.g., `qwen3.8-max`)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                contents:
                  type: array
                  items:
                    type: object
                generationConfig:
                  type: object
                safetySettings:
                  type: array
                tools:
                  type: array
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    $ref: '#/components/schemas/TexapiCost'
                  texapi:
                    $ref: '#/components/schemas/TexapiMetadata'
            text/event-stream:
              schema:
                type: string
  /v1beta/models/{model}:streamGenerateContent:
    post:
      tags:
      - Gemini
      summary: Stream generate content (Gemini format)
      description: Streaming variant of Gemini content generation
      operationId: geminiStreamGenerateContent
      parameters:
      - name: model
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Successful response
          content:
            text/event-stream:
              schema:
                type: string