topxea-com Public API

openapi: 3.2.0
info:
  title: TopxAI Public API
  version: '2026-10-25'
  summary: One OpenAI- and Anthropic-compatible endpoint for Claude, GPT, Grok, GLM, Kimi, DeepSeek and Jev.
  description: 'TopxAI relays requests to the model providers at fixed USD prices on prepaid credit. The request body is forwarded unchanged and the response is returned unchanged, except where a request in another format has to be converted for the model (for example /v1/messages to a model other than Claude), on /v1/responses, where the echoes of the request and members the upstream adds are rewritten, and on /v1/chat/completions, where provider_specific_fields, a member some upstream capacity adds, is removed; parameters not listed here pass through to the provider. A request without a system prompt that reaches the GPT provider''s Responses API (gpt-6.1-sol on every endpoint, gpt-6-astra on /v1/responses) is sent the instructions "You are a helpful assistant.", so the provider does not add its own longer prompt; a request with its own system prompt or instructions is forwarded as sent. Base URL for OpenAI-style SDKs: https://ai.topxea.com/v1. Base URL for the Anthropic SDK: https://ai.topxea.com. Prompts, completions and files are relayed in memory and never stored. Prices: https://ai.topxea.com/pricing and https://ai.topxea.com/api/pricing.'
  termsOfService: https://ai.topxea.com/user-agreement
  contact:
    name: TopxAI support
    email: support@topxea.com
    url: https://ai.topxea.com/docs
  x-logo:
    url: https://ai.topxea.com/favicon.svg
  license:
    name: Terms of use
    url: https://ai.topxea.com/user-agreement
servers:
- url: https://ai.topxea.com
  description: Production
security:
- bearerAuth: []
tags:
- name: Public
  description: No key needed.
paths:
  /api/pricing:
    get:
      tags:
      - Public
      operationId: getPricing
      security: []
      summary: The price table
      description: Every model with its route prices in USD (per 1M tokens, per image by size, per second by resolution), the routes it is enabled on, the endpoints that serve it, the provider's list price for comparison and the route an Auto-route key would pick. The same data as https://ai.topxea.com/pricing.
      responses:
        '200':
          description: The catalogue.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PricingModel'
        '429':
          description: Rate limited; retry after the Retry-After seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PricingModel:
      type: object
      properties:
        model_name:
          type: string
        description:
          type: string
        notice:
          type: string
        enable_groups:
          type: array
          items:
            type: string
        supported_endpoint_types:
          type: array
          items:
            type: string
        route_prices:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/RoutePrice'
        reference_price:
          $ref: '#/components/schemas/RoutePrice'
        reference_price_source:
          type: object
          properties:
            kind:
              type: string
            name:
              type: string
            url:
              type: string
            verified_at:
              type: string
            model:
              type: string
        auto_route:
          type: string
        context_window:
          type: integer
          description: Input context window in tokens; omitted when unknown or not applicable.
        max_output:
          type: integer
          description: Maximum output tokens; omitted when unknown or not applicable.
      additionalProperties: true
    RoutePrice:
      type: object
      properties:
        unit:
          type: string
          enum:
          - per_million_tokens
          - per_image
          - per_second
          - per_request
        input:
          type: number
        output:
          type: number
        cache_read:
          type: number
        cache_write:
          type: number
        cache_write_1h:
          type: number
        long_context:
          type: object
          properties:
            min_input_tokens:
              type: integer
            input:
              type: number
            output:
              type: number
          additionalProperties: true
        sizes:
          type: object
          additionalProperties:
            type: number
        resolutions:
          type: object
          additionalProperties:
            type: number
        unit_price:
          type: number
      additionalProperties: true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Ends with a request id to quote to support@topxea.com.
            type:
              type: string
            code:
              type:
              - string
              - integer
              - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'A TopxAI API key (sk-...) as Authorization: Bearer <key>. Keys are created at https://ai.topxea.com/keys.'
    anthropicKey:
      type: apiKey
      in: header
      name: x-api-key
      description: The same TopxAI key, the way the Anthropic SDK sends it.
externalDocs:
  description: Documentation
  url: https://ai.topxea.com/docs