> ## 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.

# 模型目录

> 查看精确的模型 ID、能力与可用状态。

> 当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

## 使用精确的模型 ID

模型名称用于展示，Model ID 标识可调用的版本或操作，例如文生图、图片编辑或音乐续写。不能根据相似名称推断兼容性。

当前预览目录使用示例模型名称。正式调用需选择已验证供应商、输入规范和价格规则的启用模型。

## 调用前检查能力

| 字段 | 检查内容 |
| - | - |
| modality | 图片、视频、音乐或 LLM。 |
| 输入规范 | 必填参数、默认值、枚举和组合约束。 |
| 可用状态 | 预览和维护模型不等于真实可用渠道。 |
| fallback 能力 | 官方渠道是否支持当前完整输入。 |

## 版本与变更

已受理请求保留模型规范、路由和价格快照。之后的调价不能改变运行中任务。新模型应先具备文档和示例，再标记可用。


## 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.