> ## Documentation Index > Fetch the complete documentation index at: https://docs.trybloom.ai/llms.txt > Use this file to discover all available pages before exploring further. # List models > List available image, video, audio, and SVG models. Filter by output type or search query. Use the returned cursor to get the next page, keeping the same filters. ## OpenAPI ````yaml https://www.trybloom.ai/api/v1/spec.json get /models openapi: 3.1.1 info: title: Bloom API version: 1.0.0 servers: - url: https://www.trybloom.ai/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Images description: Generate, edit, and retrieve images. - name: Models description: Find available models and check their inputs. - name: Generations description: Generate images, video, audio, and SVG, then retrieve the results. - name: Uploads description: >- Stage private local files for Brand sources, Library images, and other supported operations. paths: /models: get: tags: - Models summary: List models description: >- List available image, video, audio, and SVG models. Filter by output type or search query. Use the returned cursor to get the next page, keeping the same filters. operationId: models.list parameters: - name: type in: query schema: enum: - image - video - audio - svg type: string description: Filter by the type of file the model generates. allowEmptyValue: true allowReserved: true - name: query in: query schema: type: string maxLength: 200 description: Search the model catalog. allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 50 default: 20 description: Maximum number of models to return. Accepts 1–50; defaults to 20. allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string description: >- Cursor from the previous response's nextCursor. Keep the same type and query filters. allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: models: type: array items: type: object properties: id: type: string description: >- Exact model ID. Use this value when fetching model details or starting a generation. name: type: string description: Display name of the model. type: enum: - image - video - audio - svg type: string description: Type of file the model generates. description: type: string description: Description of the model and its capabilities. inputTypes: type: array items: type: string description: >- Types of input the model accepts. Check inputSchema for the fields to send. required: - id - name - type - description - inputTypes description: Models matching the filters on this page. nextCursor: anyOf: - type: string - type: 'null' description: >- Pass this value as cursor to get the next page. Null when there are no more results. hasMore: type: boolean description: Whether another page of models is available. required: - models - nextCursor - hasMore required: - data '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/ModelsList400ErrorResponse' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ModelsList401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ModelsList403ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/ModelsList429ErrorResponse' headers: Retry-After: description: >- Seconds until the API-key request limit resets. Present only when the request-rate limiter can calculate the delay. schema: type: integer minimum: 0 '503': description: '503' content: application/json: schema: $ref: '#/components/schemas/ModelsList503ErrorResponse' components: schemas: ModelsList400ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: INVALID_CURSOR status: const: 400 message: type: string default: Invalid generation model cursor data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList401ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: UNAUTHORIZED status: const: 401 message: type: string default: Invalid or missing API credentials data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList403ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: ACCOUNT_BANNED status: const: 403 message: type: string default: This account has been suspended. data: {} required: - code - status - message - type: object properties: code: const: FORBIDDEN status: const: 403 message: type: string default: Plan upgrade required data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList429ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: TOO_MANY_REQUESTS status: const: 429 message: type: string default: Rate limit exceeded data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList503ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: CATALOG_UNAVAILABLE status: const: 503 message: type: string default: Could not load generation models data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ApiError: type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Bloom API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: Bloom API key (`Bearer bloom_sk_...`) or Bloom OAuth access token. ````