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, y Herramientas de música 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 fila concreta, usa get_generation (detalle completo) o get_status (solo el estado actual).

Parámetros:

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

#get_generation

Detalle completo de una sola generación pasada: prompt, modelo, parámetros, estado, salidas, credits_deducted, error_message. Úsalo cuando tengas un id y quieras la fila entera; get_generations es el historial paginado. Se combina con regenerate para iterar: get_generation(id), revisas los parámetros, y luego regenerate(id, prompt="ajustado").

Parámetros:

Respuesta: La misma forma de fila que una entrada de get_generations.generations[].

#plan

Planificador de solo lectura. Le das el objetivo del usuario con sus propias palabras y devuelve un plan enrutado, en lugar de que hagas cuatro llamadas por separado. No cobra nada ni llama a ningún modelo.

Úsalo como primera llamada de la sesión, cuando el usuario ha descrito lo que quiere pero no ha elegido modelo.

Parámetros:

Respuesta: recommended_model, estimated_credits, estimated_seconds, requires_upload, suggested_aspect_ratio, workflow_steps[] y skills_to_fetch[]. Si la intención es ambigua recibes clarifying_questions[] en vez de un modelo: hazle esas preguntas al usuario y vuelve a llamar a plan.

#list_assets

Lista la Biblioteca de assets del usuario: imágenes, vídeos y audio con nombre y reutilizables, guardados en su bucket privado. Mira aquí antes de pedirle a alguien que vuelva a subir un logo, una cara recurrente, un clip de voz o una pista: puede que ya esté guardado.

Parámetros: Ninguno.

Respuesta: assets[], cada uno con un name estable (p. ej. tesote-logo), id, kind (image / video / audio), size_bytes y una url de CDN firmada válida una hora. Pasa esa url directamente a generate_media como valor de source_media_urls. También devuelve quota_bytes / used_bytes, un bloque team y las filas compartidas del equipo en cuentas con plan de equipo, más un bloque kling_elements cuando el usuario ha guardado paquetes de referencia.

#manage_library

La mitad de escritura de la biblioteca: añade, renombra o borra entradas de la Biblioteca de assets, y crea o borra personajes de Gemini Omni. Las lecturas siguen en list_assets y list_gemini_omni_characters: llámalas primero para confirmar qué existe.

Parámetros:

Consulta Limitaciones para límites de ritmo.