GET /models | ZUI GEN API Docs

GET/api/v1/models

Obtiene la lista de modelos disponibles con sus parametros, costos en creditos y configuraciones.

Query Parameters

Parametro	Tipo	Default	Descripcion
`include_parameters`	boolean	true	Incluir parametros detallados de cada modelo
`category`	string	-	Filtrar por categoria: "image", "video" o "audio"

Ejemplo de Request

Listar todos los modelosbash

curl https://gen.zui.es/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Filtrar solo modelos de videobash

curl "https://gen.zui.es/api/v1/models?category=video" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OKjson

{
  "models": [
    {
      "model_key": "flux/schnell",
      "model_name": "FLUX Schnell",
      "category": "image",
      "credits_cost": 5,
      "input_type": "text",
      "parameters": [
        {
          "key": "aspect_ratio",
          "label": "Aspect Ratio",
          "type": "select",
          "options": [
            { "value": "1:1", "label": "1:1 (Cuadrado)" },
            { "value": "16:9", "label": "16:9 (Horizontal)" },
            { "value": "9:16", "label": "9:16 (Vertical)" }
          ],
          "default": "1:1"
        }
      ]
    },
    {
      "model_key": "kling/v1.6-pro",
      "model_name": "Kling v1.6 Pro",
      "category": "video",
      "credits_cost": 50,
      "input_type": "text",
      "parameters": [
        {
          "key": "duration",
          "label": "Duration",
          "type": "select",
          "options": [
            { "value": "5", "label": "5 segundos" },
            { "value": "10", "label": "10 segundos" }
          ],
          "default": "5"
        },
        {
          "key": "aspect_ratio",
          "label": "Aspect Ratio",
          "type": "select",
          "options": [
            { "value": "16:9", "label": "16:9" },
            { "value": "9:16", "label": "9:16" },
            { "value": "1:1", "label": "1:1" }
          ],
          "default": "16:9"
        }
      ]
    }
  ],
  "categories": {
    "image": ["flux/schnell", "flux/pro", "ideogram/v2"],
    "video": ["kling/v1.6-pro", "sora/standard", "veo3-fast"],
    "audio": ["suno/v4", "udio/v1.5"]
  },
  "total": 45
}

Campos de Respuesta

Objeto Model

Campo	Tipo	Descripcion
`model_key`	string	Identificador unico del modelo (usar en /generate)
`model_name`	string	Nombre legible del modelo
`category`	string	"image", "video" o "audio"
`credits_cost`	number	Costo base en creditos
`input_type`	string	"text", "image", "video", "text+image"
`parameters`	array	Parametros configurables del modelo

Tipos de Input

input_type	Descripcion	Campos requeridos
`text`	Solo requiere prompt de texto	prompt
`image`	Requiere imagen como entrada	image_url
`text+image`	Requiere prompt + imagen	prompt, image_url
`video`	Requiere video como entrada	video_url