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: 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, Instrumente muzică și Instrumente reclame 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 o generare specifică, folosește get_generation_status (media) sau get_music_status (muzică) cu acel generation_id.
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.
Vezi Limitări pentru limite de rată.
