Limite de rată

    Plafoane pe minut per instrument

    30/min
    generate_media
    10/min
    generate_music
    10/min
    generate_dialogue
    5/min
    create_ad_copy
    120/min
    get_*

    Erori comune

    Ce să arăți utilizatorului

    Rate limit (429)

    Prea multe cereri într-un interval scurt. Așteaptă până la minutul următor, nu intra în bucle.

    Credite insuficiente (402)

    Sold prea mic pentru jobul cerut. Spune-i utilizatorului să încarce — nu reîncerca automat.

    Token invalid sau expirat

    Reautorizează clientul MCP din Kubeez (Setări → MCP → reconectează).

    Parametri invalizi

    Model greșit pentru generation_type, media de input lipsă etc. Verifică get_models.

    Limitări

    Pagina se concentrează pe instrumentele MCP (nume precum generate_media, get_models). API-ul REST folosește rute și unele limite de rată diferite; vezi API REST.

    #Limite de rată

    Cererile sunt limitate pe minut per cont (sau per token client conectat). Limite aproximative:

    Instrument sau categorieLimită (cereri pe minut)
    generate_media30
    generate_music, generate_dialogue10
    create_ad_copy5
    get_generation_status, get_music_status, get_models, get_balance, get_generations, get_generation_estimate120

    Dacă depășești limita, serverul returnează o eroare rate limited. Așteaptă puțin (ex. până în minutul următor) înainte de a reîncerca. Clientul poate afișa un mesaj precum „Prea multe cereri” sau „Limită depășită”.

    #Credite

    • Toate generările (media, muzică, reclame) consumă credite Kubeez din contul tău.
    • Costul depinde de model și opțiuni (ex. calitate, durată). Folosește get_models pentru a vedea costul per generare pentru fiecare model.
    • Înainte de a porni un job, folosește get_balance pentru a te asigura că ai suficiente credite. Altfel, cererea poate eșua cu eroare de credite insuficiente.
    • Poți achiziționa sau reîncărca credite din contul Kubeez.

    #Erori

    • Rate limited – Prea multe cereri într-un timp scurt. Reîncearcă după o scurtă așteptare.
    • Credite insuficiente – Soldul este prea mic pentru operațiunea solicitată. Adaugă credite în contul Kubeez.
    • Token invalid sau expirat – Re-autorizează clientul MCP din Kubeez (ex. deconectează și reconectează).
    • Parametri invalizi – ex. model greșit pentru tipul de generare ales sau imagine de intrare lipsă când modelul o necesită. Verifică get_models și documentația instrumentelor (ex. Instrumente media).

    #Limite specifice instrumentelor

    #generate_dialogue

    • Minim caractere: 5 caractere în total.
    • Maxim caractere: 5.000 de caractere în total per generare.
    • Joburi concurente: Până la 5 generări simultane.

    #generate_media

    • Joburi concurente: Până la 10 generări simultane.

    #generate_music

    • Joburi concurente: Până la 5 generări simultane.

    Când o generare eșuează, răspunsul de status include de obicei un mesaj de eroare care descrie ce nu a mers bine.

    Vezi Cum funcționează pentru fluxuri recomandate și comportament la reîncercare.