--- title: List Models | Luma Agents --- GET /v1/models Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/models'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request GET \ --url https://agents.lumalabs.ai/v1/models \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/models List every generation model this client can reach, with its capabilities. Each row carries the model id to pass as `default_generation_models` on `POST /v1/sessions`, the public brand aliases that resolve to it, and the aspect ratios, resolutions, clip durations, reference slots, frame slots and audio support of every action it exposes. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Query Parameters **modality** Any of: - [Modality](#tab-panel-0-0) - [null](#tab-panel-0-1) *Modality* What a model row is for, in the vocabulary the SDK contract publishes. string Allowed values: image video audio edit utility null Filter to one modality. **id** Any of: - [string](#tab-panel-1-0) - [null](#tab-panel-1-1) string null Filter to one model id or brand alias. ## Responses ### 200 Successful Response Media typeapplication/json *ModelsResponse* Body of `GET /v1/models`. object **models** *Models* Array\ *Model* A public model id and everything an SDK caller needs to plan against it. object **actions** *Actions* Array\ *ActionCapabilities* One registry action exposed under a model row. object **action\_id** required *Action Id* string **capabilities** required *ModelCapabilities* What one action — or the union of a model's create actions — can produce. object **aspect\_ratios** *Aspect Ratios* Array\ **audio** *Audio* boolean **custom\_dimensions** *Custom Dimensions* boolean **durations\_s** Any of: - [DurationSupport](#tab-panel-2-0) - [null](#tab-panel-2-1) *DurationSupport* Durations one action accepts — a continuous slider or a fixed picker. object **max** Any of: - [number](#tab-panel-3-0) - [null](#tab-panel-3-1) number null **min** Any of: - [number](#tab-panel-4-0) - [null](#tab-panel-4-1) number null **step** Any of: - [number](#tab-panel-5-0) - [null](#tab-panel-5-1) number null **values** Any of: - [Array\](#tab-panel-6-0) - [null](#tab-panel-6-1) Array\ null null **end\_frame** *End Frame* boolean **max\_references** Any of: - [integer](#tab-panel-7-0) - [null](#tab-panel-7-1) integer null **output\_type** *OutputType* Media type an action produces. string default: image Allowed values: image video audio text **references\_with\_start\_frame** Any of: - [boolean](#tab-panel-8-0) - [null](#tab-panel-8-1) boolean null **resolutions** *Resolutions* Array\ **seed** *Seed* boolean **start\_frame** *Start Frame* boolean **voices** Any of: - [Array\](#tab-panel-9-0) - [null](#tab-panel-9-1) Array\ null **kind** required *ActionKind* Public name for what one action does to media. string Allowed values: create edit extend reframe stitch mux tts music sfx lipsync stems isolation transcribe layering **pricing** Any of: - [ModelPricing](#tab-panel-10-0) - [null](#tab-panel-10-1) *ModelPricing* Credit rates keyed by pricing variant, from the action's pricing schema. object **credits** *Credits* Credits per unit, keyed by variant (such as a resolution, or key=value pairs joined by |); `default` when there is one rate. object ***key*** additional properties integer **currency** *Currency* string default: credits **estimate** *Estimate* True when the charge settles on what the run used (such as tokens), so these credits are an estimate and the charge can differ. boolean **unit** required *Unit* What one rate is charged per, named for what it counts: such as flat for one output, per\_second for each second of output duration, or per\_megapixel\_second for output area times duration. string null **aliases** *Aliases* Array\ **availability** *ModelAvailability* Whether the caller may run the model right now. string default: available Allowed values: available requires\_upgrade disabled **capabilities** required *ModelCapabilities* What one action — or the union of a model's create actions — can produce. object **aspect\_ratios** *Aspect Ratios* Array\ **audio** *Audio* boolean **custom\_dimensions** *Custom Dimensions* boolean **durations\_s** Any of: - [DurationSupport](#tab-panel-11-0) - [null](#tab-panel-11-1) *DurationSupport* Durations one action accepts — a continuous slider or a fixed picker. object **max** Any of: - [number](#tab-panel-12-0) - [null](#tab-panel-12-1) number null **min** Any of: - [number](#tab-panel-13-0) - [null](#tab-panel-13-1) number null **step** Any of: - [number](#tab-panel-14-0) - [null](#tab-panel-14-1) number null **values** Any of: - [Array\](#tab-panel-15-0) - [null](#tab-panel-15-1) Array\ null null **end\_frame** *End Frame* boolean **max\_references** Any of: - [integer](#tab-panel-16-0) - [null](#tab-panel-16-1) integer null **output\_type** *OutputType* Media type an action produces. string default: image Allowed values: image video audio text **references\_with\_start\_frame** Any of: - [boolean](#tab-panel-17-0) - [null](#tab-panel-17-1) boolean null **resolutions** *Resolutions* Array\ **seed** *Seed* boolean **start\_frame** *Start Frame* boolean **voices** Any of: - [Array\](#tab-panel-18-0) - [null](#tab-panel-18-1) Array\ null **id** required *Id* string **modality** required *Modality* What a model row is for, in the vocabulary the SDK contract publishes. string Allowed values: image video audio edit utility **pricing** Any of: - [ModelPricing](#tab-panel-19-0) - [null](#tab-panel-19-1) *ModelPricing* Credit rates keyed by pricing variant, from the action's pricing schema. object **credits** *Credits* Credits per unit, keyed by variant (such as a resolution, or key=value pairs joined by |); `default` when there is one rate. object ***key*** additional properties integer **currency** *Currency* string default: credits **estimate** *Estimate* True when the charge settles on what the run used (such as tokens), so these credits are an estimate and the charge can differ. boolean **unit** required *Unit* What one rate is charged per, named for what it counts: such as flat for one output, per\_second for each second of output duration, or per\_megapixel\_second for output area times duration. string null ##### Example ```json { "models": [ { "actions": [ { "capabilities": { "audio": false, "custom_dimensions": false, "end_frame": false, "output_type": "image", "seed": false, "start_frame": false }, "kind": "create", "pricing": { "currency": "credits", "estimate": false } } ], "availability": "available", "capabilities": { "audio": false, "custom_dimensions": false, "end_frame": false, "output_type": "image", "seed": false, "start_frame": false }, "modality": "image", "pricing": { "currency": "credits", "estimate": false } } ] } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```