Instrumente cont

Kubeez

Folosește aceste instrumente pentru a lista modelele, verifica soldul de credite și vizualiza istoricul generărilor.

#Modele disponibile și prețuri

O listă live a modelelor activate și prețurile lor (sincronizate cu baza de date) se află la Modele disponibile. Modelele dezactivate sunt ascunse acolo și în get_models.

get_models returnează toate modelele disponibile cu prețul în credite și timpul tipic de generare. Folosește-l pentru a alege un model și a confirma costul înainte de generare.

Prețuri: Fiecare model include cost_per_generation (credite).
Timp estimat: Fiecare model include estimated_time_seconds (durata tipică de generare). Primești atât costul cât și durata estimată într-un singur apel; nu e nevoie de un instrument separat de estimare per model.
Folosește doar modelele listate: Când apelezi generate_media sau generate_music, folosește un model_id din răspunsul get_models. Folosirea unui model care nu e în listă poate duce la eroare.

Filtrează după model_type (image, video sau music) pentru a obține modele pentru o capabilitate specifică. Vezi Instrumente media, și Instrumente muzică pentru utilizarea modelelor per instrument.

#get_models

Returnează modelele AI disponibile cu costuri și capabilități. Apelează-l înainte de generare pentru a alege modelul potrivit și a confirma costul.

Parametri:

Parametru	Tip	Obligatoriu	Descriere
model_type	string	Nu	Filtrare după tip: `image`, `video` sau `music`. Omitere pentru toate.

Răspuns: O listă de modele. Fiecare intrare include în general:

model_id – Folosește-l în generate_media sau generate_music. Folosește doar ID-urile returnate aici.
display_name, provider
model_type (image, video, music)
cost_per_generation (credite)
estimated_time_seconds (durata tipică de generare)
generation_types (ex. text-to-image, image-to-video)
requires_input_media, input_media_types (ex. o imagine)
capabilities (rapoarte de aspect, durate, niveluri de calitate etc.)

Folosește aceste informații pentru a decide ce model să folosești și dacă trebuie să trimiți source_media_urls pentru media.

#get_balance

Returnează soldul curent de credite Kubeez.

Parametri: Niciunul (folosește contul tău autentificat).

Răspuns: Creditele tale disponibile (și opțional ultima actualizare). Verifică înainte de generări costisitoare.

#get_generations

Returnează ultimele 20 de generări (media) cu filtre opționale (ex. pentru a lista joburile recente și output-ul sau linkurile sursă). Pentru un singur rând, folosește get_generation (detaliu complet) sau get_status (doar starea curentă).

Parametri:

Parametru	Tip	Obligatoriu	Descriere
status	string	Nu	Filtrare după status (ex. completed, failed).
model	string	Nu	Filtrare după ID model.
generation_type	string	Nu	Filtrare după tip (ex. text-to-image).

Răspuns: Până la 20 de generări cu ID-uri, prompturi, modele, status, timestamp-uri și detalii de output.

#get_generation

Detaliu complet pentru o singură generare anterioară: prompt, model, parametri, status, output-uri, credits_deducted, error_message. Folosește-l când ai un singur id și vrei tot rândul; get_generations e istoricul paginat. Se combină cu regenerate pentru iterație: get_generation(id), inspectezi parametrii, apoi regenerate(id, prompt="ajustat").

Parametri:

Parametru	Tip	Obligatoriu	Descriere
id	string	Da	generation_id.

Răspuns: Aceeași formă de rând ca o intrare din get_generations.generations[].

#plan

Planificator read-only. Îi dai obiectivul utilizatorului în cuvintele lui și îți întoarce un plan rutat, în locul a patru apeluri separate. Nu taxează nimic și nu apelează niciun model.

Folosește-l ca primul apel dintr-o sesiune, când utilizatorul a descris ce vrea dar nu a ales un model.

Parametri:

Parametru	Tip	Obligatoriu	Descriere
intent	string	Da	Ce vrea utilizatorul, în cuvintele lui.
has_local_files	boolean	Nu	True când utilizatorul a atașat imagine sau audio de referință.
has_video_reference	boolean	Nu	True când utilizatorul a atașat un video pe care vrea să îl modifice. Rutează către un model cu referință video în loc de text- sau image-to-video.
target_aspect	string	Nu	Forțează un aspect ratio în loc să îl deducă planificatorul.

Răspuns: recommended_model, estimated_credits, estimated_seconds, requires_upload, suggested_aspect_ratio, workflow_steps[] și skills_to_fetch[]. Dacă intenția e ambiguă primești clarifying_questions[] în loc de un model — pune-i utilizatorului acele întrebări, apoi apelează plan din nou.

#list_assets

Listează biblioteca de assets a utilizatorului: imagini, videoclipuri și audio denumite și reutilizabile, stocate în bucket-ul lui privat. Verifică aici înainte să ceri cuiva să re-încarce un logo, o față recurentă, un clip de voce sau o piesă — s-ar putea să fie deja salvate.

Parametri: Niciunul.

Răspuns: assets[], fiecare cu un name stabil (ex. tesote-logo), id, kind (image / video / audio), size_bytes și un url CDN semnat valabil o oră. Trimite acel url direct în generate_media ca valoare source_media_urls. Întoarce și quota_bytes / used_bytes, un bloc team și rândurile partajate cu echipa pentru conturile pe plan de echipă, plus un bloc kling_elements când utilizatorul a salvat pachete de referință.

#manage_library

Jumătatea de scriere a bibliotecii: adaugă, redenumește sau șterge intrări din biblioteca de assets și creează sau șterge personaje Gemini Omni. Citirile rămân pe list_assets și list_gemini_omni_characters — apelează-le întâi ca să confirmi ce există.

Parametri:

Parametru	Tip	Obligatoriu	Descriere
kind	string	Da	`asset` sau `character`.
action	string	Da	Assets: `add`, `rename`, `delete`. Personaje: `create`, `delete`.
name	string	Nu	Handle pentru `add` de asset: litere mici, cifre, `_` și `-`, maxim 64 de caractere, unic per utilizator.
url	string	Nu	Sursa remote pentru `add` de asset. Serverul o descarcă și validează tipul MIME.
shared	boolean	Nu	Doar conturi de echipă: `true` salvează în biblioteca partajată, `false` în cea personală. E alegerea utilizatorului — dacă îl omiți pe un cont de echipă primești `shared_scope_required` în loc de o presupunere.
asset_id	string	Nu	UUID din list_assets, pentru `rename` sau `delete`.
new_name	string	Nu	Handle nou pentru `rename`.
descriptions	string	Nu	Text de aspect / identitate pentru `create` de personaj.
image_url	string	Nu	jpeg / png / webp public pentru `create` de personaj.
character_name	string	Nu	Nume afișat opțional pentru `create` de personaj.
voice_id	string	Nu	Voce opțională din list_gemini_omni_voices.
character_id	string	Nu	Câmpul `id` din list_gemini_omni_characters, pentru `delete`.

Vezi Limitări pentru limite de rată.