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

# List the models of every generation operation

> Lists the models of every operation of POST /create/generations, or of one with operation: each one's id, name, operation, best use, default, field values, media and how many, what does not combine, and typical credits per image, second or track, with their basis. ad_adaptation and motion have one model each, which runs without a model field. The exact price comes from POST /create/generations with estimateOnly. Free. The workspace must have generation enabled (public_create): otherwise 403 feature_not_enabled.

Requires the `create:read` scope.



## OpenAPI

````yaml /api-reference/openapi.json get /create/models
openapi: 3.1.0
info:
  title: Unite API
  version: 1.0.0
  description: >-
    Run Ad Score pre-tests from your own systems: upload a creative, create a
    pre-test, and read its result and PDF report. The Ad Score routes are under
    /adscore and need the adscore:read or adscore:write scope; uploads and
    webhook endpoints are shared by every product and stay at the root. Every
    request needs an API key sent as a Bearer token. Every response carries an
    X-Request-Id header.
servers:
  - url: https://myunite.ai/api/v1
security:
  - bearerAuth: []
tags:
  - name: Catalog
    description: What you can send when you create a pre-test.
  - name: Uploads
    description: Send creative files and brand assets.
  - name: Brands
    description: Create and complete brands for your workspace.
  - name: Pretests
    description: Create pre-tests and read their results.
  - name: Quota
    description: How many pre-tests you can still run.
  - name: Create
    description: Generate and edit images, videos and music, and read what was generated.
  - name: Webhooks
    description: Manage the endpoints that are notified when a pre-test changes.
paths:
  /create/models:
    get:
      tags:
        - Create
      summary: List the models of every generation operation
      description: >-
        Lists the models of every operation of POST /create/generations, or of
        one with operation: each one's id, name, operation, best use, default,
        field values, media and how many, what does not combine, and typical
        credits per image, second or track, with their basis. ad_adaptation and
        motion have one model each, which runs without a model field. The exact
        price comes from POST /create/generations with estimateOnly. Free. The
        workspace must have generation enabled (public_create): otherwise 403
        feature_not_enabled.


        Requires the `create:read` scope.
      operationId: listCreateModels
      parameters:
        - name: operation
          in: query
          required: false
          description: Return only the models of this operation.
          schema:
            type: string
            enum:
              - image
              - video
              - upscale
              - cutout
              - reframe
              - audio
              - ad_adaptation
              - motion
              - speech
              - lipsync
              - montage
      responses:
        '200':
          description: The models.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateModelList'
        '401':
          description: >-
            Error. Possible codes: invalid_api_key, api_key_revoked,
            api_key_expired.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Error. Possible codes: feature_not_enabled, key_owner_not_member,
            insufficient_scope.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: 'Error. Possible codes: invalid_request.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: 'Error. Possible codes: rate_limited.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: 'Error. Possible codes: internal_error.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  headers:
    X-Request-Id:
      description: >-
        Identifier of this request. Quote it when you email support@myunite.ai.
        It is also in error.requestId.
      schema:
        type: string
    RateLimit-Limit:
      description: >-
        Requests allowed per minute for this key and bucket: 600 for reads, 60
        for writes. Sent on responses once the key is accepted. On 401 errors
        and on 403 errors raised while the key is checked they may be absent.
      schema:
        type: integer
    RateLimit-Remaining:
      description: Requests left in the current window.
      schema:
        type: integer
    RateLimit-Reset:
      description: Seconds until the oldest counted request leaves the window.
      schema:
        type: integer
    Retry-After:
      description: Seconds to wait before you try again.
      schema:
        type: integer
  schemas:
    CreateModelList:
      type: object
      properties:
        models:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              mediaType:
                type: string
                enum:
                  - image
                  - video
                  - audio
              bestFor:
                type: string
              default:
                type: boolean
              options:
                type: object
                propertyNames:
                  type: string
                additionalProperties:
                  type: array
                  items:
                    type:
                      - string
                      - number
                      - boolean
                description: >-
                  The values each field takes on this model, of the type the
                  tool takes: seconds as numbers, audio as booleans.
              mediaRoles:
                type: array
                items:
                  type: object
                  properties:
                    param:
                      type: string
                    kind:
                      type: string
                      enum:
                        - image
                        - video
                        - audio
                    max:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                  required:
                    - param
                    - kind
                    - max
                description: >-
                  Each media argument the model takes, by the kind of file, with
                  how many.
              combinations:
                type: array
                items:
                  type: string
                description: What the model does not take together, or takes only together.
              pricing:
                type: object
                properties:
                  unit:
                    type: string
                    enum:
                      - image
                      - second
                      - track
                  minCredits:
                    type: number
                  maxCredits:
                    type: number
                  basis:
                    type: string
                    description: What the typical prices assume.
                required:
                  - unit
                  - minCredits
                  - maxCredits
                  - basis
                description: >-
                  Typical credits per unit; the exact price of a request comes
                  from estimateOnly.
              operation:
                type: string
                enum:
                  - image
                  - video
                  - upscale
                  - cutout
                  - reframe
                  - audio
                  - ad_adaptation
                  - motion
                  - speech
                  - lipsync
                  - montage
                description: >-
                  The operation of POST /create/generations that runs this
                  model.
            required:
              - id
              - name
              - mediaType
              - bestFor
              - default
              - options
              - mediaRoles
              - combinations
              - pricing
              - operation
      required:
        - models
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - invalid_api_key
                - api_key_revoked
                - api_key_expired
                - insufficient_scope
                - insufficient_role
                - confirmation_required
                - content_rejected
                - insufficient_credits
                - spend_limit_reached
                - feature_not_enabled
                - key_owner_not_member
                - rate_limited
                - concurrency_limit
                - invalid_request
                - idempotency_key_required
                - idempotency_conflict
                - idempotency_key_retired
                - upload_not_found
                - upload_invalid
                - file_too_large
                - video_too_long
                - source_url_rejected
                - source_url_unreachable
                - invalid_ooh_format
                - voice_origin_mismatch
                - invalid_placement
                - brand_not_found
                - quota_exhausted
                - not_found
                - report_not_ready
                - pretest_in_progress
                - webhook_url_rejected
                - webhook_endpoint_limit
                - internal_error
              description: >-
                Stable machine-readable code. Branch on this, not on the
                message. voice_origin_mismatch is legacy: no longer returned.
            message:
              type: string
              description: Human-readable explanation in English. Its wording can change.
            requestId:
              type: string
              description: >-
                Same value as the X-Request-Id response header. Quote it when
                you email support@myunite.ai.
            docUrl:
              type: string
              description: Page that explains this code.
            param:
              description: >-
                The field, query parameter or header the error refers to, when
                there is one.
              type: string
          required:
            - code
            - message
            - requestId
            - docUrl
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key, sent as `Authorization: Bearer unite_live_...`. Create keys in
        the workspace settings.

````

## Related topics

- [List generations, or read several by id](https://docs.myunite.ai/api-reference/create/list-generations-or-read-several-by-id.md)
- [Generate or edit an image, a video or music, or quote it](https://docs.myunite.ai/api-reference/create/generate-or-edit-an-image-a-video-or-music-or-quote-it.md)
- [Get a generation](https://docs.myunite.ai/api-reference/create/get-a-generation.md)
- [List webhook endpoints](https://docs.myunite.ai/api-reference/webhooks/list-webhook-endpoints.md)
- [List pre-tests](https://docs.myunite.ai/api-reference/pretests/list-pre-tests.md)


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