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: Compara modelos con price_for, que asocia una duración en segundos con el coste completo en créditos para esa duración (si falta, el modelo no puede generar esa duración), junto con billing_unit (per_second, per_generation, per_1000_chars o per_minute) y rate para la unidad de cobro. cost_per_generation es un campo heredado y no sirve para comparar modelos: en los que cobran por segundo es una duración de ejemplo ya multiplicada.
    • 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:

    ParámetroTipoObligatorioDescripción
    model_typestringNoFiltra por tipo: image, video o music. Omite para todos.

    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)
    • billing_unit, rate y price_for (compara modelos con price_for; cost_per_generation es heredado y no comparable entre modelos)
    • 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.


    <a id="pick_model"></a>

    #pick_model

    Elige un solo modelo para un trabajo, con alternativas con precio y el motivo por el que se descartó cada una. Úsalo en lugar de leer todo el catálogo de get_models cuando estés eligiendo modelo: solo el catálogo de vídeo supera con creces el centenar de filas. No genera nada ni cuesta créditos; continúa con estimate y generate_media.

    Describe el trabajo, no un modelo, y describe las entradas con honestidad: pasa images: 1 cuando el usuario haya adjuntado una imagen, o recibirás un modelo que no puede usar el archivo.

    Parámetros:

    ParámetroTipoObligatorioDescripción
    modalitystringNovideo (por defecto), image, music o speech.
    images / videos / audios / documentsnumberNoCuántos archivos de cada tipo vas a adjuntar. Por defecto 0.
    duration_snumberNoDuración del clip en segundos, para vídeo.
    spoken_languagestringNoIdioma de la voz en el resultado. Por defecto none.
    wants_recurring_characterbooleanNotrue cuando la misma persona o voz tiene que repetirse en varios clips.
    nsfwbooleanNoContenido para adultos.
    aspect_ratiostringNoRelación de aspecto deseada.
    tierstringNovalue (por defecto) o quality devuelven la opción de calidad de esa categoría; cheapest devuelve como principal el modelo capaz más barato.
    user_named_modelstringNoUn modelo que el usuario pidió por su nombre. Se devuelve tal cual, con su precio y un capability_warning si las entradas no encajan. La herramienta nunca cambia un modelo nombrado por el usuario por otra familia u otro nivel.

    Respuesta: primary (la elección), alternates encabezadas por el modelo capaz más barato con su precio, rejected con lo que no podía hacer el trabajo y por qué, y cheaper_option cuando la vía barata cuesta bastante menos que la principal. Si aparece cheaper_option, comunica ambas cifras al usuario.


    #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:

    ParámetroTipoObligatorioDescripción
    statusstringNoFiltra por estado (p. ej. completed, failed).
    modelstringNoFiltra por ID de modelo.
    generation_typestringNoFiltra por tipo (p. ej. text-to-image).

    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:

    ParámetroTipoObligatorioDescripción
    idstringSíEl generation_id.

    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:

    ParámetroTipoObligatorioDescripción
    intentstringSíLo que quiere el usuario, con sus palabras.
    has_local_filesbooleanNoTrue cuando el usuario adjuntó imagen o audio de referencia.
    has_video_referencebooleanNoTrue cuando el usuario adjuntó un vídeo que quiere modificar. Enruta a un modelo con referencia de vídeo en vez de texto o imagen a vídeo.
    target_aspectstringNoFuerza un aspect ratio en lugar de dejar que el planificador lo deduzca.

    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:

    ParámetroTipoObligatorioDescripción
    kindstringSíasset o character.
    actionstringSíAssets: add, rename, delete. Personajes: create, delete.
    namestringNoHandle para un add de asset: minúsculas, dígitos, _ y -, máximo 64 caracteres, único por usuario.
    urlstringNoOrigen remoto para un add de asset. El servidor lo descarga y valida el tipo MIME.
    sharedbooleanNoSolo cuentas de equipo: true guarda en la biblioteca compartida, false en la personal. Es decisión del usuario: omitirlo en una cuenta de equipo devuelve shared_scope_required en lugar de adivinar.
    asset_idstringNoUUID de list_assets, para rename o delete.
    new_namestringNoHandle nuevo para un rename.
    descriptionsstringNoTexto de apariencia / identidad para un create de personaje.
    image_urlstringNojpeg / png / webp público para un create de personaje.
    character_namestringNoNombre visible opcional para un create de personaje.
    voice_idstringNoVoz opcional de list_gemini_omni_voices.
    character_idstringNoEl campo id de list_gemini_omni_characters, para delete.

    Consulta Limitaciones para límites de ritmo.