GenMagic Models API

openapi: 3.2.0
info:
  title: GenMagic Models API
  version: 1.0.0
  description: 'GenMagic is one studio for every generative AI model. Turn a single prompt into text, images, video, audio, music, or code, and route it to the best model automatically. New models the day they launch.


    OpenAI-compatible REST API plus a remote Model Context Protocol server at /api/mcp (Streamable HTTP, protocol 2025-06-18). Authenticate with an API key minted at https://genmagic.co/get-api-key; the model catalog (GET /api/v1/models) also answers without one. Billed pay-as-you-go against a prepaid USD balance; cost and remaining balance are returned in response headers.'
servers:
- url: https://genmagic.co
security:
- bearerAuth: []
tags:
- name: Models
paths:
  /api/v1/models:
    get:
      operationId: listModels
      summary: List models with full detail
      description: 'OpenAI-compatible model list enriched with capabilities, pricing, and benchmarks from the same live catalog the studio uses, newest first (by created, a Unix timestamp in seconds). Text models also carry supported_parameters, capabilities.reasoning_efforts and reasoning_mandatory, and cache, reasoning and long-context (tiers) prices where the model publishes them; audio models carry audio_kind (speech or music), the endpoint that runs them. A pure lookup: spends no credits, and works without a key. This is a lookup and spends no credits.'
      security:
      - {}
      - bearerAuth: []
      responses:
        '200':
          description: Success.
          headers:
            X-RateLimit-Limit:
              schema:
                type: string
              description: The key's request quota for the current rate-limit window.
            X-RateLimit-Remaining:
              schema:
                type: string
              description: Requests left for this key in the current rate-limit window.
            X-RateLimit-Reset:
              schema:
                type: string
              description: Seconds until the current rate-limit window resets.
        '401':
          description: 'authentication_error: invalid API key (a request without a key is answered anonymously).'
        '429':
          description: 'rate_limit_error: over 300 requests/minute for this key.'
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
          enum:
          - text
          - image
          - audio
          - video
          description: Filter by output category.
        description: Filter by output category.
      - name: capability
        in: query
        required: false
        schema:
          type: string
          enum:
          - reasoning
          - vision
          - tools
          - structured
          description: Filter by capability.
        description: Filter by capability.
      - name: audio_kind
        in: query
        required: false
        schema:
          type: string
          enum:
          - speech
          - music
          description: Only speech or only music models (audio models carry audio_kind).
        description: Only speech or only music models (audio models carry audio_kind).
      - name: search
        in: query
        required: false
        schema:
          type: string
          description: Substring of a model id or name.
        description: Substring of a model id or name.
      tags:
      - Models
  /api/v1/models/{id}:
    get:
      operationId: getModel
      summary: Retrieve one model's full detail
      description: 'OpenAI-compatible client.models.retrieve. A pure lookup: spends no credits, and works without a key. Model ids contain a slash, e.g. /api/v1/models/openai/gpt-image-2. This is a lookup and spends no credits.'
      security:
      - {}
      - bearerAuth: []
      responses:
        '200':
          description: Success.
          headers:
            X-RateLimit-Limit:
              schema:
                type: string
              description: The key's request quota for the current rate-limit window.
            X-RateLimit-Remaining:
              schema:
                type: string
              description: Requests left for this key in the current rate-limit window.
            X-RateLimit-Reset:
              schema:
                type: string
              description: Seconds until the current rate-limit window resets.
        '401':
          description: 'authentication_error: invalid API key (a request without a key is answered anonymously).'
        '429':
          description: 'rate_limit_error: over 300 requests/minute for this key.'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          description: The model id (may contain slashes).
        description: The model id (may contain slashes).
      tags:
      - Models
  /api/v1/models/changes:
    get:
      operationId: listModelChanges
      summary: What changed in the model catalog, day by day
      description: 'New models (by the catalog''s listing date), price changes with the price before and after, retirements, returns, changed details, and benchmark scores that appeared or changed, per UTC day, with how many model pages each day touched: the data behind genmagic.co/models/changes. A pure lookup: spends no credits, and works without a key. This is a lookup and spends no credits.'
      security:
      - {}
      - bearerAuth: []
      responses:
        '200':
          description: Success.
          headers:
            X-RateLimit-Limit:
              schema:
                type: string
              description: The key's request quota for the current rate-limit window.
            X-RateLimit-Remaining:
              schema:
                type: string
              description: Requests left for this key in the current rate-limit window.
            X-RateLimit-Reset:
              schema:
                type: string
              description: Seconds until the current rate-limit window resets.
        '401':
          description: 'authentication_error: invalid API key (a request without a key is answered anonymously).'
        '429':
          description: 'rate_limit_error: over 300 requests/minute for this key.'
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          description: How many days back, 1 to 90 (default 7).
        description: How many days back, 1 to 90 (default 7).
      tags:
      - Models
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'GenMagic API key in the form gm_live_..., sent as Authorization: Bearer <key>. Also accepted as x-api-key.'