Sari la conținut

Cast

Videoclipuri și podcasturi făcute din propriile tale fișiere, contacte și chaturi.

Deschide Cast
Verificat față de tabloul de bord la 20 noiembrie 2026

Cast nu are astăzi metode API publice. Fiecare metodă a lui poartă marcajul private, deci nicio cheie API nu poate apela vreuna, nici măcar o cheie cu acces complet. Metodele de mai jos sunt cele pe care ecranele Cast le apelează dintr-o sesiune autentificată a dashboardului. Sunt listate ca să știi ce fac ecranele, nu ca ceva de apelat din propriul tău cod.

Un videoclip sau un podcast se face în dashboard: din pagina Cast sau trăgând Cast peste un contact, un grup de contacte, un chat AI ori o bază de cunoștințe, pentru un videoclip rapid. Din exterior, doar fișierul final este la îndemână:

  • Un fișier final este un fișier obișnuit din Drive, în folderul stabilit în setările Cast, așa că tot ce oferă Drive pentru fișiere funcționează și pe el.

Fiecare metodă acționează în numele proprietarului spațiului de lucru și răspunde cu code 1 când reușește. O refuzare răspunde cu un code negativ și spune de ce în data. Fiecare metodă primește un workspace_id opțional, pentru a acționa într-un spațiu de lucru pe care îl deții, altul decât cel principal, și fiecare metodă cere o sesiune cu clearance de utilizator.

Piesele

Un videoclip sau un podcast este o piesă: un document cu un id care începe cu cst_, urmat de 16 caractere hex. Scenele lui încep cu sc_, urmat de 8 caractere hex.

  • get_casts listează videoclipurile și podcasturile spațiului de lucru, cele mai noi primele. Împreună cu lista răspunde cu planul și limitele lui, generările din luna aceasta, valorile implicite salvate, dacă acest server poate genera și un preț tipic în credite pentru fiecare pas.
  • get_cast citește o piesă cu brieful, elementele, storyboardul și starea ei. Cu frames setat la true, fiecare scenă poartă și imaginea primului ei cadru, ca data URL.
  • get_cast_frame citește imaginea unei scene (cast_id, scene_id) ca data URL.
  • save_cast creează o piesă sau modifică una. Primește cast_id (gol creează una nouă), title (o linie, până la 120 de caractere), brief (tip, scop, descriere, limbă, voce, personaj principal, lungime, dimensiune, aspect și opțiuni; cheile pe care nu le cunoaște sunt ignorate. voice_language, un cod de limbă al dashboardului, este limba în care sunt numite vocile cât timp language este auto: gazdele unui podcast își spun pe nume cu acele nume. Dashboardul îl setează la propria lui limbă când creează o piesă), sources (până la 20 de elemente) și copy_of, care pornește o ciornă nouă din brieful, elementele și storyboardul altei piese. Este refuzată cât timp un script sau o generare lucrează la piesă.
  • delete_cast șterge o piesă și cadrele ei. Fișierul generat din ea rămâne în Drive.

Un spațiu de lucru păstrează până la 200 de piese. Elementele unei piese sunt fișiere și foldere Drive, contacte, grupuri de contacte, chat-uri AI, baze de cunoștințe, piloți, linkuri și notițe. Un conector este păstrat, dar încă nu poate fi citit.

Scriptul și storyboardul

  • read_cast_reference urmărește un videoclip YouTube doar pentru stilul lui și răspunde cu ce păstrează un brief din el, ca reference: aspectul (culori, font, colțuri, cameră, tranziții și cât durează, forma subtitrărilor), tempoul (secunde pe cadru, tăieturi pe minut), ritmul vorbirii, scurte note despre cum este făcut și ce sugerează pentru brief (tip, scop, gen, formă, lungime). Primește url. Rulează ca job (pași: se urmărește videoclipul, se citește stilul lui) și folosește credite AI. O piesă îl urmează când brieful ei conține reference și style este reference: scriptul este scris pe tempoul lui, iar generarea taie cu tranzițiile lui. Nimic din conținutul videoclipului nu se păstrează.
  • write_cast_script scrie scriptul pe baza briefului și a elementelor: scene cu primul cadru al fiecăreia pentru un videoclip, replici pentru un podcast. Primește cast_id și o instruction opțională de până la 600 de caractere. Rulează ca job (pași: se citesc elementele tale, se scrie scriptul, se desenează primele cadre), iar scripturile și imaginile folosesc credite AI.
  • edit_cast_storyboard aplică în ordine până la 60 de modificări: confirm, unconfirm, confirm_all, delete, delete_all, move și set (cuvintele unei scene, subtitrarea ei de pe ecran, titlul, cifra, punctele, citatul și aspectul unui card și ce gazdă spune o replică). O modificare prost formată refuză întregul apel. Răspunde cu cadrele pe care le-a desenat din nou.
  • redo_cast_scene refă o scenă. mode este rewrite, picture (o imagine nouă, cuvintele rămân), insert (o scenă nouă la position, numărând de la 0) sau kind (schimbă ce arată scena: title, card, picture, stock, screenshot, presenter sau podcast). instruction are până la 600 de caractere. Rulează ca job, iar imaginile și scrisul folosesc credite AI.

Generarea și publicarea

  • build_cast generează fișierul din storyboardul confirmat și îl salvează în Drive. O scenă neconfirmată îl refuză, cu excepția cazului în care confirm_all este true. Rulează ca job (pași: se înregistrează vocea, se pregătesc imaginile, se asamblează scenele, se mixează sunetul, se salvează în Drive). Vocile și imaginile folosesc credite AI, iar o generare reușită se numără în limita lunii.
  • stop_cast_build oprește generarea care lucrează la o piesă.
  • publish_cast partajează o piesă generată. way este link, care pornește linkul (sau îl oprește, cu off setat la true), sau email, care trimite linkul la până la 10 adrese din to, cu un message opțional de până la 1000 de caractere. Oricine are linkul poate vedea sau asculta până când fișierul este șters.
  • quick_cast face un videoclip infografic rapid despre un contact, un grup de contacte, un chat AI sau o bază de cunoștințe: target_kind (contact, contact_group, chat sau knowledge_base), target_id, un target_name opțional pentru titlu și o language opțională, folosită când setările spun Auto. Folosește valorile implicite salvate în setări. Rulează ca job (pași: se citește elementul, se scrie scriptul, se desenează cadrele, se generează videoclipul).

Un server generează o singură piesă la un moment dat, pentru toată lumea. Un spațiu de lucru ocupă cel mult două locuri în acea coadă, unul care generează și unul care așteaptă, iar al treilea este refuzat.

Setări și planuri

  • save_cast_settings salvează valorile implicite pentru piesele noi și pentru videoclipurile rapide: language (auto sau un cod de limbă al dashboardului), voice și gender, voice2 și gender2 pentru a doua gazdă, character, seconds, size (9:16, 1:1, 4:5 sau 16:9), style, captions, music, quick_build și folder. Se schimbă doar cheile pe care le trimiți.
  • get_cast_plans citește planurile cu prețurile, funcțiile și drepturile lor, planul pe care este contul, dacă Cast este pornit și generările folosite în luna aceasta.
  • cast_set_plan pornește Cast, schimbă planul (plan_id este cast_free, cast_starter, cast_growth sau cast_business) sau îl oprește (un plan_id gol sau deactivate setat la true). Oprirea păstrează fiecare videoclip și podcast. Ambele metode de plan primesc un billing_workspace_id opțional, care contează doar după ce planurile Cast se vor ține pe spațiu de lucru.

Ce este refuzat

Dashboardul spune fiecare dintre acestea în cuvinte, lângă control. În răspunsul metodei sunt un code negativ cu o propoziție în data:

  • Doar proprietarul unui spațiu de lucru poate face videoclipuri și podcasturi în el. Un chat public cu Assistant nu poate.
  • Cast este oprit pentru cont sau numărul de generări al planului pe lună este folosit (o generare este refuzată, un script nu).
  • Lungimea sau numărul de scene depășește ce permite planul.
  • Se lucrează la piesă. Un script sau o generare lucrează la ea, deci nu poate fi salvată sau editată până când se termină sau este oprită.
  • Nu sunt destule credite AI pentru a plăti un script, o imagine sau o voce.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026