> ## Documentation Index > Fetch the complete documentation index at: https://docs.melius.com/llms.txt > Use this file to discover all available pages before exploring further. # List generative models ## OpenAPI ````yaml /api/openapi.json get /api/v1/generation/models openapi: 3.0.2 info: title: Melius API version: '1' description: >- The Melius REST API. Authenticate with an API key as a bearer token (`Authorization: Bearer mel_...`) and select the team to act on with the `x-team-id` header. Generations run through the same node + run pipeline as the app: create a node on a canvas, start a run, poll the run, then read the resulting version asset. servers: - url: https://api.melius.com security: - apiKey: [] teamId: [] paths: /api/v1/generation/models: get: tags: - model summary: List generative models operationId: model.list parameters: - name: category in: query required: true schema: type: string enum: - image - video - text - image_tool - video_tool - audio responses: '200': description: '200' content: application/json: schema: type: object properties: models: type: array items: type: object properties: name: type: string displayName: type: string releasedAt: type: string nullable: true variants: type: array items: type: object properties: mode: type: string tier: type: string nullable: true requiredInputs: type: array items: type: string optionalInputs: type: array items: type: string supportsSeed: type: boolean supportsAudioGeneration: type: boolean supportsAudioToggle: type: boolean supportsNegativePrompt: type: boolean supportedAspectRatios: type: array items: type: string enum: - '21:9' - '16:9' - '4:3' - '5:4' - '3:2' - '1:1' - '2:3' - '3:4' - '4:5' - '9:16' - '9:21' supportedDurations: type: array items: type: number nullable: true billedDurationSource: oneOf: - type: string enum: - input-media - type: number supportedDurationsByResolution: type: object additionalProperties: type: array items: type: number nullable: true supportedResolutions: type: array items: oneOf: - type: string enum: - 360p - 480p - 540p - 580p - 720p - 1080p - 1440p - 2160p - 4k - 0.5K - 1K - 2K - 4K - 1k - 2k - type: string nullable: true supportsCustomResolution: type: boolean maxImageInputs: type: number nullable: true maxReferenceImageInputs: type: number nullable: true maxReferenceImagesWithEndImage: type: number nullable: true maxVideoInputs: type: number nullable: true maxAudioInputs: type: number nullable: true maxNativeOutputs: type: number nullable: true maxInputArea: type: number nullable: true inputImageFileSizeConstraints: type: object properties: maximumFileBytes: type: integer minimum: 0 maximumTotalBytes: type: integer minimum: 0 nullable: true inputReferenceImageFileSizeConstraints: type: object properties: maximumFileBytes: type: integer minimum: 0 maximumTotalBytes: type: integer minimum: 0 nullable: true inputImageDimensionConstraints: type: object properties: minimumWidth: type: integer minimum: 0 minimumHeight: type: integer minimum: 0 maximumWidth: type: integer minimum: 0 maximumHeight: type: integer minimum: 0 required: - minimumWidth - minimumHeight nullable: true inputImageAspectRatioConstraints: type: object properties: maximumRatio: type: number minimum: 0 exclusiveMinimum: true required: - maximumRatio nullable: true inputImageMimeTypes: type: array items: type: string nullable: true inputReferenceImageMimeTypes: type: array items: type: string nullable: true minInputVideoArea: type: number nullable: true maxInputVideoDurationSeconds: type: number nullable: true minInputVideoDurationSeconds: type: number nullable: true maxPromptLength: type: number nullable: true minPromptLength: type: number nullable: true estimatedLatency: type: string nullable: true estimatedLatencySeconds: type: number nullable: true defaultResolution: oneOf: - type: string enum: - 360p - 480p - 540p - 580p - 720p - 1080p - 1440p - 2160p - 4k - 0.5K - 1K - 2K - 4K - 1k - 2k - type: string featuredDescription: type: string nullable: true cost: oneOf: - type: object properties: type: type: string enum: - fixed creditCost: type: number required: - type - creditCost - type: object properties: type: type: string enum: - fixed_duration creditCost: type: number durationSeconds: type: number required: - type - creditCost - durationSeconds - type: object properties: type: type: string enum: - per_second creditCostPerSecond: type: number required: - type - creditCostPerSecond - type: object properties: type: type: string enum: - per_minute creditCostPerMinute: type: number required: - type - creditCostPerMinute - type: object properties: type: type: string enum: - per_megapixel_frame creditCostPerMegapixelFrame: type: number estimatedCreditCost: type: number required: - type - creditCostPerMegapixelFrame - type: object properties: type: type: string enum: - estimated creditCost: type: number required: - type - creditCost required: - mode - tier - requiredInputs - optionalInputs - supportsSeed - supportedAspectRatios - supportedDurations - supportedResolutions - maxImageInputs - maxNativeOutputs - maxInputArea - estimatedLatency - featuredDescription supportedInputs: type: array items: type: string enum: - image - video estimatedLatency: type: string nullable: true estimatedLatencySeconds: type: number nullable: true featuredDescription: type: string nullable: true cost: oneOf: - type: object properties: type: type: string enum: - fixed creditCost: type: number required: - type - creditCost - type: object properties: type: type: string enum: - fixed_duration creditCost: type: number durationSeconds: type: number required: - type - creditCost - durationSeconds - type: object properties: type: type: string enum: - per_second creditCostPerSecond: type: number required: - type - creditCostPerSecond - type: object properties: type: type: string enum: - per_minute creditCostPerMinute: type: number required: - type - creditCostPerMinute - type: object properties: type: type: string enum: - per_megapixel_frame creditCostPerMegapixelFrame: type: number estimatedCreditCost: type: number required: - type - creditCostPerMegapixelFrame - type: object properties: type: type: string enum: - estimated creditCost: type: number required: - type - creditCost deprecated: type: boolean hiddenFromAgent: type: boolean promoRateLimit: type: object properties: used: type: integer minimum: 0 limit: type: integer minimum: 0 remaining: type: integer minimum: 0 required: - used - limit - remaining maxPromptLength: type: number nullable: true required: - name - displayName - variants - cost required: - models '401': description: Missing, invalid, expired, or revoked API key. content: application/json: schema: type: object properties: statusCode: type: integer error: type: string message: type: string required: - statusCode - message '403': description: The API key's user is not a member of the requested team. content: application/json: schema: type: object properties: statusCode: type: integer error: type: string message: type: string required: - statusCode - message '429': description: Rate limit reached — retry after the `Retry-After` header. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: type: object properties: statusCode: type: integer error: type: string message: type: string retryAfterSeconds: type: integer required: - statusCode - message components: securitySchemes: apiKey: type: http scheme: bearer description: 'A Melius API key (`mel_...`), sent as `Authorization: Bearer `.' teamId: type: apiKey in: header name: x-team-id description: The team (workspace) to act on. Defaults to the key's team when omitted. ````