Conectare rapidă

    Adaugă Kubeez în Cursor cu un click

    OAuth se deschide în browser — fără editare JSON, fără token de lipit.

    Prezentare MCP

    Serverul MCP Kubeez permite asistenților AI precum Claude, Cursor și ChatGPT să folosească instrumentele Kubeez nativ — fără SDK, fără cod de integrare. O singură conexiune, toate instrumentele creative.

    #Ce poți face

    • Imagini și video — peste 40 de modele pentru text-to-image, image-to-image, text-to-video, image-to-video, motion control și lip-sync.
    • Muzică — piese complete cu voce sau instrumentale, cu versuri personalizate, stil și BPM opționale.
    • Dialog — text-to-speech cu mai multe voci (peste 80).
    • Subtitrări — transcrieri cu marcaje de timp la nivel de cuvânt din orice videoclip.
    • Separare audio — împarte o piesă în voce + instrumental.
    • Reclame — variante de reclame pornind de la o reclamă de referință și produsul tău.

    #Conectare

    Folosește această URL când adaugi serverul în clientul MCP:

    https://mcp.kubeez.com/mcp
    

    #Cursor — un click

    Adaugă în Cursor

    Folosește fluxul oficial de instalare Cursor — fără editare JSON.

    #Autentificare

    MetodăCând o folosești
    OAuth (recomandat)Cursor, Claude Desktop și majoritatea clienților deschid un browser, te autentifici la Kubeez, clientul stochează tokenul. Nimic de lipit.
    Token de acces personalClienți care acceptă doar API key (ex. GPT-uri personalizate ChatGPT). Generează unul la Setări → MCP, lipește-l ca Bearer / API key. Aceleași permisiuni ca OAuth, revocabil oricând.

    Dacă clientul acceptă headere personalizate, folosește Authorization: Bearer <token> cu un token de acces personal.

    #Cum funcționează

    1. Adaugă URL-ul serverului în clientul MCP.
    2. Autentifică-te la Kubeez (OAuth) și aprobă capabilitățile cerute.
    3. Clientul primește un token și poate apela instrumentele — generările folosesc creditele tale Kubeez.

    Toate instrumentele de generare sunt asincrone: pornești un job, apoi consulți statusul până la finalizare. Clientul gestionează polling-ul automat; pagina Cum funcționează explică fluxul dacă construiești unul propriu.

    #Cerințe

    • Un cont Kubeez cu credite.
    • Orice client compatibil MCP (Claude Desktop, Cursor, Claude.ai, GPT-uri personalizate ChatGPT, integrare proprie).

    Pentru acces HTTP / API key direct (servere, scripturi, backend mobile), folosește REST API.


    Mai departe: Pornire rapidă — conectează și rulează prima generare în 5 minute.

    Secvențe reale de instrumente

    Cum înlănțuie asistenții AI aceste instrumente

    Separare muzică — împarte o piesă în voce + instrumental

    Separare audio cu facturare exactă pe durată.

    1. 1
      get_upload_url(model_id="mvsep-40")

      Întoarce un link temporar de browser. Trimite-l utilizatorului ca atare.

    2. 2
      get_upload_session(token)

      Întoarce media_urls + total_audio_seconds + billing_readiness:"exact".

    3. 3
      estimate_generation_cost(model="mvsep-40", reference_audio_seconds=…)

      Citează prețul. Niciun credit dedus.

    4. 4
      generate_separation(media_url=…) → get_separation_status

      Primul poll ~20s, apoi la fiecare 5s. Întoarce URL-urile de voce + instrumental.

    Motion control — animă un personaj dintr-un video

    Două încărcări, ordonate, facturate după durata videoului de referință.

    1. 1
      get_upload_url(model_id="kling-3-0-motion-control-720p")

      Linkul impune 1 imagine + 1 video.

    2. 2
      get_upload_session(token)

      media_urls ordonate + total_video_seconds.

    3. 3
      estimate_generation_cost(model="…motion-control-720p", reference_video_seconds=…)

      Confirmă înainte să taxezi.

    4. 4
      generate_media(source_media_urls=[image_url, video_url])

      Ordinea contează: imagine prima, video al doilea.

    AutoCaptions — transcrie un video în subtitrări la nivel de cuvânt

    Sincron — subtitrările vin în răspuns.

    1. 1
      get_upload_url(model_id="auto-caption")

      Același tipar: trimite linkul utilizatorului.

    2. 2
      get_upload_session(token) → total_video_seconds

      Citește durata direct din sesiune.

    3. 3
      estimate_generation_cost(model="auto-caption", reference_video_seconds=…)

      Citează costul pe secundă în avans.

    4. 4
      generate_captions(media_url=…)

      Apel sincron — întoarce JSON la nivel de cuvânt în răspuns (fără polling).

    Sfaturi

    Fă-o bine din prima

    Previzualizează costul înainte de generare

    Modelele pe durată (Music Separation, AutoCaptions, motion control, P-Video, Seedance 2 cu video de referință) taxează pe secundele de referință. Apelează estimate_generation_cost întâi, citează numărul, așteaptă confirmarea.

    Polling cu cadență mică

    Primul poll folosește estimated_time_seconds din get_models, apoi la fiecare 5s. Pollul la fiecare secundă consumă rate-limit pentru același timp de finalizare.

    Încărcări din browser → facturare exactă

    Fișierele încărcate prin get_upload_url au durata măsurată client-side. billing_readiness:"exact". URL-urile externe cad pe valoarea pesimistă de 15s.

    Scope-urile sunt la nivel de instrument

    get_models nu cere scope. generate_* cere generate:media / generate:music / generate:speech / generate:ads. read:balance și read:generations acoperă interogările.