Instrumente cont
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: Compară modelele după price_for, care asociază o durată în secunde cu costul complet în credite la acea lungime (dacă lipsește, modelul nu poate randa durata respectivă), împreună cu billing_unit (
per_second,per_generation,per_1000_charssauper_minute) și rate pentru unitatea de bază. cost_per_generation este un câmp vechi și nu poate fi comparat între modele: la modelele facturate pe secundă este un exemplu de durată deja înmulțit. - 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)
- billing_unit, rate și price_for (compară modelele după
price_for; cost_per_generation este un câmp vechi, necomparabil între modele) - 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.
<a id="pick_model"></a>
#pick_model
Alege un singur model pentru o sarcină, cu alternative cu preț și motivul pentru care alte modele au fost excluse. Preferă-l în locul citirii întregului catalog get_models atunci când alegi un model: doar catalogul video are mult peste o sută de rânduri. Nu generează nimic și nu costă credite; continuă cu estimate și generate_media.
Descrie sarcina, nu un model, și descrie corect intrările: trimite images: 1 când utilizatorul a atașat o imagine, altfel primești un model care nu poate prelua fișierul.
Parametri:
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| modality | string | Nu | video (implicit), image, music sau speech. |
| images / videos / audios / documents | number | Nu | Câte fișiere de fiecare tip vei atașa. Implicit 0. |
| duration_s | number | Nu | Durata clipului în secunde, pentru video. |
| spoken_language | string | Nu | Limba vorbirii din rezultat. Implicit none. |
| wants_recurring_character | boolean | Nu | true când aceeași persoană sau voce trebuie să apară în mai multe clipuri. |
| nsfw | boolean | Nu | Conținut pentru adulți. |
| aspect_ratio | string | Nu | Raportul de aspect dorit. |
| tier | string | Nu | value (implicit) sau quality întorc alegerea de calitate pentru categoria respectivă; cheapest întoarce ca alegere principală cel mai ieftin model capabil. |
| user_named_model | string | Nu | Un model cerut de utilizator pe nume. Este întors ca atare, cu prețul lui și un capability_warning dacă intrările nu se potrivesc. Instrumentul nu înlocuiește niciodată un model numit de utilizator cu altă familie sau alt tier. |
Răspuns: primary (alegerea), alternates începând cu cel mai ieftin model capabil și prețul lui, rejected cu modelele care nu pot face sarcina și motivul, și cheaper_option când varianta ieftină costă semnificativ mai puțin decât cea principală. Când există cheaper_option, comunică utilizatorului ambele sume.
#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ă.