Herramientas de cuenta

Usa estas herramientas para listar modelos, comprobar tu saldo de créditos y ver el historial de generaciones.

#Modelos disponibles y precios

Una lista viva de modelos habilitados y sus precios (sincronizada con la base de datos) está en Modelos disponibles. Los modelos deshabilitados se ocultan ahí y en get_models.

get_models devuelve todos los modelos disponibles con su precio en créditos y tiempo típico de generación. Úsalo para elegir modelo y confirmar coste antes de generar.

• Precios: Cada modelo incluye cost_per_generation (créditos).
• Tiempo estimado: Cada modelo incluye estimated_time_seconds (duración típica). Obtienes coste y duración en una sola llamada; no hace falta otra herramienta de estimación por modelo.
• Usa solo modelos listados: Al llamar a generate_media o generate_music, usa un model_id de la respuesta de get_models. Usar un modelo fuera de esa lista puede producir error.

Filtra por model_type (image, video o music) para modelos de una capacidad concreta. Consulta Herramientas de medios, Herramientas de música y Herramientas de anuncios para el uso por herramienta.

#get_models

Devuelve modelos de IA disponibles con costes y capacidades. Llama antes de generar para elegir modelo y confirmar coste.

Parámetros:

Respuesta: Lista de modelos. Cada entrada suele incluir:

• model_id — Úsalo en generate_media o generate_music. Solo IDs devueltos aquí.
• display_name, provider
• model_type (image, video, music)
• cost_per_generation (créditos)
• estimated_time_seconds (duración típica)
• generation_types (p. ej. text-to-image, image-to-video)
• requires_input_media, input_media_types (p. ej. una imagen)
• capabilities (relaciones de aspecto, duraciones, niveles de calidad, etc.)

Úsalo para decidir qué modelo usar y si debes pasar source_media_urls en medios.

#get_balance

Devuelve tu saldo actual de créditos Kubeez.

Parámetros: Ninguno (usa tu cuenta autenticada).

Respuesta: Créditos disponibles (y opcionalmente última actualización). Comprueba esto antes de generaciones costosas.

#get_generations

Devuelve tus últimas 20 generaciones (medios) con filtros opcionales (p. ej. para listar trabajos recientes y sus salidas o enlaces de origen). Para una generación concreta, usa get_generation_status (medios) o get_music_status (música) con ese generation_id.

Parámetros:

Respuesta: Hasta 20 generaciones con IDs, prompts, modelos, estado, marcas de tiempo y detalles de salida.

Consulta Limitaciones para límites de ritmo.