Cum funcționează

#Fluxuri tipice

#Media (imagine sau video)

1. Apelează opțional get_models pentru a alege un model și a vedea costul; apelează get_balance pentru a confirma că ai suficiente credite.
2. Apelează generate_media cu prompt, model și opțiuni. Primești un generation_id.
3. Interoghează get_generation_status cu acel ID la câteva secunde (ex. 2–5 secunde) până când status este completed sau failed.
4. Când e finalizat, folosește array-ul outputs: fiecare element are url (calitate maximă), thumbnail_url și opțional optimized_url. Folosește ce se potrivește (previzualizare vs descărcare).

#Muzică

1. Apelează opțional get_balance și get_models (music) pentru a verifica creditele și costul.
2. Apelează generate_music cu prompt, stil și opțiuni. Primești un generation_id.
3. Interoghează get_music_status cu acel ID până când status este completed sau failed.
4. Când e finalizat, folosește array-ul songs: fiecare piesă are audio_url, title, lyrics și adesea image_url.

#Reclame

1. Apelează create_ad_copy cu URL-ul imaginii de reclamă de referință și produsul tău (URL imagine de produs încărcată de utilizator sau text) și opțiuni. Primești generation_ids (câte unul per variantă).
2. Pentru fiecare ID, interoghează get_generation_status (ca la media) până la finalizare.
3. Folosește URL-urile imaginilor returnate pentru fiecare variantă.

#Bune practici

• Verifică soldul și costul mai întâi – Apelează get_balance și get_models înainte de generări costisitoare ca utilizatorii să nu fie surprinși de eșecuri sau costuri.
• Respectă cerințele modelelor – Pentru media, trimite source_media_urls doar când modelul suportă image-to-video sau image-to-image. Folosește get_models pentru a vedea ce modele necesită media de intrare.
• Interoghează rezonabil – Folosește un interval de 2–5 secunde la interogarea statusului. Setează un timp maxim de așteptare (ex. 5–10 minute pentru media, mai mult pentru muzică/reclame) și afișează un mesaj de timeout dacă jobul nu se finalizează.
• Gestionează erorile – La limită de rată (ex. 429), așteaptă și reîncearcă. La credite insuficiente sau parametri invalizi, afișează un mesaj clar și nu reîncearca aceeași cerere fără acțiunea utilizatorului.
• Folosește URL-ul potrivit – Pentru previzualizări folosește thumbnail_url sau optimized_url; pentru calitate maximă folosește url.

Vezi Limitări pentru limite de rată și comportamentul creditelor.