List models

GET

models

List models

curl --request GET \
  --url https://havincy.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://havincy.com/api/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "id": "fal-kling-v3-pro",
      "object": "model",
      "name": "Kling 3.0 Pro",
      "modality": "video",
      "track": "video",
      "credits_per_output": 186,
      "default": true,
      "text_to_output": true,
      "accepts_reference_images": true,
      "max_reference_images": 1,
      "max_outputs_per_request": 1,
      "options": {
        "aspect_ratios": ["16:9", "9:16", "1:1"],
        "durations_seconds": [5, 8, 10, 15],
        "resolutions": ["720p", "1080p"],
        "generate_audio": { "default": true }
      }
    }
  ]
}

Lists the AI models available for generation, grouped by modality (image, video, audio, 3d). Each model gives its credit cost per output, whether it accepts reference images, and the valid options (aspect ratios, durations, resolutions, voices). Use the returned id as model_id. Required permission: read. MCP tool: list_models.

string

Only this modality (default: all). Allowed values: image, video, audio, 3d.

string

Audio only: voice (text to speech) or music.

{
  "object": "list",
  "data": [
    {
      "id": "fal-kling-v3-pro",
      "object": "model",
      "name": "Kling 3.0 Pro",
      "modality": "video",
      "track": "video",
      "credits_per_output": 186,
      "default": true,
      "text_to_output": true,
      "accepts_reference_images": true,
      "max_reference_images": 1,
      "max_outputs_per_request": 1,
      "options": {
        "aspect_ratios": ["16:9", "9:16", "1:1"],
        "durations_seconds": [5, 8, 10, 15],
        "resolutions": ["720p", "1080p"],
        "generate_audio": { "default": true }
      }
    }
  ]
}

⌘I

List models

curl --request GET \
  --url https://havincy.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://havincy.com/api/v1/models', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "id": "fal-kling-v3-pro",
      "object": "model",
      "name": "Kling 3.0 Pro",
      "modality": "video",
      "track": "video",
      "credits_per_output": 186,
      "default": true,
      "text_to_output": true,
      "accepts_reference_images": true,
      "max_reference_images": 1,
      "max_outputs_per_request": 1,
      "options": {
        "aspect_ratios": ["16:9", "9:16", "1:1"],
        "durations_seconds": [5, 8, 10, 15],
        "resolutions": ["720p", "1080p"],
        "generate_audio": { "default": true }
      }
    }
  ]
}

Overview

Account & models

Generation

Encore effects

Library & brand

Social publishing