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

# List models

> Discover exact model IDs, capabilities, and availability.

> API preview: generation providers are not connected. An authenticated request can return 503 without creating a task or charging credits.

## Use an exact model ID

A model name is a display label. The model ID identifies a callable version or operation, such as text-to-image, image editing, or music continuation. Do not infer compatibility from a similar display name.

Preview entries currently use illustrative model names. Select an enabled model only after its real provider, input schema, and price rules have been verified.

## Read capabilities before sending

| Field | What to check |
| - | - |
| modality | Image, video, music, or LLM. |
| input schema | Required inputs, defaults, enums, and combinations. |
| availability | Preview and maintenance entries are not live routes. |
| fallback support | Whether an official route supports this exact input. |

## Versions and changes

Accepted requests keep their model schema, route, and price snapshots. A later price edit must not retroactively change a running task. New models should include documentation and examples before becoming available.


## OpenAPI

````yaml openapi.json GET /v1/models
openapi: 3.1.0
info:
  title: APIstable API preview
  version: 0.1.0-preview
  description: >-
    Current implemented HTTP surface. / 当前已实现的 HTTP 接口。 Models and quote prices
    are illustrative. Real providers and paid generation are not connected. POST
    /v1/tasks and /v1/chat/completions return 503 provider_not_configured after
    authentication and applicable validation; no credits are reserved or
    charged. Live 202 acceptance, provider callbacks, SSE, idempotent task
    creation, and full model capability adapters remain future integration work.
    Website login sessions are separate from application API keys.
servers:
  - url: https://apistable.com
    description: APIstable API
security: []
tags:
  - name: Models
  - name: Quotes
  - name: Tasks
  - name: Credits
  - name: LLM
paths:
  /v1/models:
    get:
      tags:
        - Models
      summary: List preview models / 获取预览模型
      description: >-
        Public catalog. No API key required. Every returned model currently has
        live_available=false. Display names and capabilities are illustrative.
      operationId: listModels
      responses:
        '200':
          description: Preview model catalog
          content:
            application/json:
              schema:
                type: object
                required:
                  - object
                  - data
                properties:
                  object:
                    const: list
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Model'
      security: []
components:
  schemas:
    Model:
      type: object
      required:
        - id
        - object
        - owned_by
        - modality
        - status
        - live_available
        - max_output_count
        - native_outputs
      properties:
        id:
          type: string
        object:
          const: model
        owned_by:
          type: string
          description: Illustrative display provider; not proof of a live integration.
        modality:
          type: string
          enum:
            - image
            - video
            - music
            - llm
        status:
          const: preview
        live_available:
          const: false
        max_output_count:
          type: integer
          enum:
            - 1
            - 4
        native_outputs:
          type: integer
          minimum: 1

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.