For the complete documentation index, see llms.txt. This page is also available as Markdown.

Models

List the FLORA models your API key can use, with each model's ID, parameters, typical run time and base price in US dollars.

The models endpoint lists the generation models available to your account, so you can pass a valid model ID and params to Generations. Filter by type to see only image, video, audio, text or 3D models.

List models

curl "https://app.flora.ai/api/v1/models?type=image" \
  -H "Authorization: Bearer $FLORA_API_KEY"
import { FloraClient } from "@flora-ai/flora"

const client = new FloraClient()

const { models } = await client.models.list({ type: "video" })
for (const model of models) {
  console.log(model.model_id, model.name, `$${model.estimated_cost_usd}`)
}

Response (trimmed):

{
  "models": [
    {
      "model_id": "t2i-flux-2-pro",
      "name": "Flux 2 Pro",
      "type": "image",
      "provider": "fal",
      "capabilities": ["text-to-image"],
      "estimated_cost_usd": 0.036,
      "estimated_seconds": 30,
      "params": [
        { "name": "aspect_ratio", "type": "string", "default": "square_1_1", "options": [{ "label": "Landscape (16:9)", "value": "landscape_16_9" }] },
        { "name": "seed", "type": "seed", "min": 0, "max": 1000000000 }
      ]
    }
  ],
  "featured": [{ "model_id": "t2i-flux-2-pro", "name": "Flux 2 Pro", "type": "image" }]
}
Field
Notes

model_id

Pass this as model on POST /generate

capabilities

What the model does, such as text-to-image or image-to-video

estimated_cost_usd

Base price of one generation in US dollars. Parameters can change it; get an exact figure with a quote

estimated_seconds

Typical run time

params

Accepted parameters: names, types, defaults, ranges and allowed values. Media inputs such as image_url or image_urls are listed here too

featured

FLORA's curated picks, when present; each model_id matches an entry in models

type accepts image, video, audio, text or model3d.

Common endpoints

Method
Path
Description

Notes

  • Model availability changes over time. Store the model_id the API returns, never a display name, and re-list when a model is rejected.

  • Quote prices to people in US dollars from estimated_cost_usd. The response also has estimated_credits, a legacy unit kept for compatibility.

  • Comparing models and rates? See Model pricing and the model pages in these docs, such as Flux 2 Pro.

  • Working from a Technique? Its inputs already define what it needs; start from Techniques.

  • From an AI client, FLORA MCP's flora_list_models returns the same IDs; see Model and LoRA tools.

Last updated

Was this helpful?