> ## Documentation Index > Fetch the complete documentation index at: https://hedra.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Models ## OpenAPI ````yaml openapi.json get /models openapi: 3.1.0 info: title: Hedra Web API version: 0.1.0 servers: - url: https://api.hedra.com/web-app/public description: Hedra Public API security: [] paths: /models: get: tags: - Public summary: List Models operationId: list_models_public_models_get parameters: - name: types in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Types responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/AIModel' title: Response List Models Public Models Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: AIModel: properties: id: type: string title: Id description: ID of the model name: type: string title: Name description: Name of the model description: anyOf: - type: string - type: 'null' title: Description description: Description of the model. type: type: string title: Type description: Type of generation the model applies to. aspect_ratios: anyOf: - items: type: string type: array - type: 'null' title: Aspect Ratios description: Aspect ratios the model supports. resolutions: anyOf: - items: type: string type: array - type: 'null' title: Resolutions description: Resolutions the model supports. durations: anyOf: - items: type: string type: array - type: 'null' title: Durations description: Durations the model supports. requires_start_frame: anyOf: - type: boolean - type: 'null' title: Requires Start Frame description: Whether the model is conditioned by a start frame. requires_end_frame: anyOf: - type: boolean - type: 'null' title: Requires End Frame description: Whether the model is conditioned by an end frame. requires_audio_input: anyOf: - type: boolean - type: 'null' title: Requires Audio Input description: Whether the model is conditioned by audio input. requires_input_video: anyOf: - type: boolean - type: 'null' title: Requires Input Video description: Whether the model requires video input (video-to-video). requires_character_orientation: anyOf: - type: boolean - type: 'null' title: Requires Character Orientation description: Whether the model requires character orientation (motion control). max_duration_ms: anyOf: - type: integer - type: 'null' title: Max Duration Ms description: >- Maximum video duration in milliseconds. Only applies to audio-driven models. custom_resolution: anyOf: - type: boolean - type: 'null' title: Custom Resolution description: Whether the model supports custom resolution. price_details: $ref: '#/components/schemas/AIModelPrice' description: Pricing details of the model. pricing: anyOf: - $ref: '#/components/schemas/Pricing' - type: 'null' description: >- Extensible pricing information with dimension modifiers for resolution, audio, etc. dimensions: anyOf: - additionalProperties: additionalProperties: $ref: '#/components/schemas/Dimension' type: object type: object - type: 'null' title: Dimensions description: Width and height for each aspect_ratio and resolution tuple. logo_url: anyOf: - type: string - type: 'null' title: Logo Url description: URL of the model's logo in SVG format. premium: type: boolean title: Premium description: Whether this is a premium model. default: true display_order: anyOf: - type: integer - type: 'null' title: Display Order description: Display order for UI sorting. Lower values appear first. type: object required: - id - name - description - type - price_details title: AIModel HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError AIModelPrice: properties: credit_cost: type: integer title: Credit Cost description: Credit cost of the model. unit_scale: type: integer title: Unit Scale description: Unit scaling for the cost. billing_unit: type: string title: Billing Unit description: >- Billing unit of the model (e.g. 'generation', 'second', 'character'). type: object required: - credit_cost - unit_scale - billing_unit title: AIModelPrice Pricing: properties: base_cost: anyOf: - type: integer - type: 'null' title: Base Cost description: >- Flat base cost in credits. Present for per-generation models (images). Duration-based models leave this unset. credits_per_second: anyOf: - type: integer - type: 'null' title: Credits Per Second description: >- Credit cost per second. Only present for duration-based models. Image/per-generation models leave this unset. modifiers: additionalProperties: additionalProperties: type: number description: |- Pricing modifier multiplier applied to a dimension option. - 1.0 = no change (base price) - 2.0 = double the base price - 0.5 = half the base price type: object type: object title: Modifiers description: >- Pricing modifiers by dimension. Each dimension (e.g. 'resolution', 'generate_audio') maps option values to their price multipliers. Only non-1.0 modifiers are included (1.0 is the implicit default). Example: {'resolution': {'540p': 0.5, '1080p': 3.0}} type: object title: Pricing description: >- Extensible pricing information for AI models. Price is calculated as: credits = ceil((base_cost + credits_per_second * duration_seconds) * product(modifiers)) For video models (per-second billing): - base_cost is typically 0 - credits_per_second is the per-second rate - duration_seconds is the video length - modifiers adjust for resolution, audio generation, etc. For image models (per-generation billing): - base_cost is the flat cost per generation (e.g., 5 credits) - credits_per_second is 0 - duration_seconds is ignored (or 0) - modifiers can still adjust for resolution, style, etc. Modifiers are only included when they affect pricing (i.e., non-1.0 values). Dimension: properties: width: type: integer title: Width description: Width of the image. height: type: integer title: Height description: Height of the image. type: object required: - width - height title: Dimension ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````