Catálogo de modelos

El catálogo devuelve los slugs exactos, las capacidades, los parámetros de entrada y los precios base de los modelos disponibles para su clave de API. Cambia sin que se publique una nueva versión del SDK, así que la fuente de verdad es la respuesta en vivo de GET /v1/models, no las tablas de esta página.

Catálogo en vivo

Authorization: Bearer <CLIPIA_API_KEY>

curl -X GET "https://api.clipia.ai/v1/models"

{
  "data": [
    {
      "slug": "nano-banana-2",
      "type": "image",
      "name": "Nano Banana 2",
      "capabilities": [
        "text-to-image",
        "image-to-image"
      ],
      "pricing": {
        "credits": 12
      }
    },
    {
      "slug": "seedance-2-fast-i2v",
      "type": "video",
      "name": "Seedance 2 Fast",
      "capabilities": [
        "image-to-video"
      ],
      "pricing": {
        "credits": 40,
        "note": "зависит от длительности/разрешения"
      }
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_api_key",
    "message": "API-ключ отсутствует, неверный или отозван."
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after the reset window.",
    "retry_after_seconds": 12
  }
}

curl https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY"

const { data } = await clipia.models.list();

// La lista puede incluir modelos LLM sin slug: deje solo los modelos de generación
const media = data.filter((model) => "slug" in model && model.slug);
console.log(media.map(({ slug, type }) => ({ slug, type })));

catalog = clipia.models.list()

# La lista puede incluir modelos LLM sin slug: deje solo los modelos de generación
media = [m for m in catalog["data"] if m.get("slug")]
print([(m["slug"], m["type"]) for m in media])

Cada modelo de generación de la respuesta tiene slug, type, name, capabilities y pricing. El conjunto puede variar entre entornos y cambiar más deprisa que esta documentación.

Modelos de imagen

Modelos de vídeo

Modelos de audio

Slugs con barra

Nueve modelos tienen un slug del tipo family/model. Páselo en la ruta tal cual, sin codificar la barra: POST /v1/models/google/imagen4, GET /v1/models/google/imagen4, POST /v1/models/google/imagen4/estimate. En el servidor MCP, páselo como parámetro model de la herramienta generate_image o generate_video.

El vídeo de Grok Imagine también tiene el slug corto grok-imagine-video-1-5: ambos apuntan al mismo modelo.

Esquema de un modelo

curl https://api.clipia.ai/v1/models/gpt-image-2 \
  -H "Authorization: Bearer $CLIPIA_KEY"

Al enviar, pase dentro del campo input solo claves de input_schema. Si el modelo no existe o está inactivo, la respuesta es 404 con el código not_found y el mensaje model_not_found.

Disponibilidad de modelos nuevos

Un modelo está disponible a través de la API solo cuando su slug exacto aparece en GET /v1/models. Un anuncio o una página de producto no son esa señal. Los slugs seedance-2-5-t2v y seedance-2-5-i2v están preparados para Seedance 2.5, pero se activan por separado en cada entorno. La landing de Seedance 2.5 para clientes solo se abre cuando ambos modos están activos. Compruebe siempre el catálogo en vivo antes de enviar.