Ugrás a tartalomhoz

Cast

Videók és podcastok a saját fájljaiból, kapcsolataiból és csevegéseiből.

Cast megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 20.

A Castnak ma nincsenek nyilvános API-metódusai. Minden metódusa private jelölést visel, így egyiket sem hívhatja meg egyetlen API-kulcs sem, még a teljes hozzáférésű sem. Az alábbi metódusokat a Cast képernyői hívják, bejelentkezett irányítópult-munkamenetből. Azért vannak felsorolva, hogy tudja, mit csinálnak a képernyők, nem azért, hogy a saját kódjából hívja őket.

Videót vagy podcastot az irányítópulton készíthet: a Cast saját oldaláról, vagy úgy, hogy a Castot egy névjegyre, egy névjegycsoportra, egy AI-csevegésre vagy egy tudásbázisra húzza egy gyorsvideóért. Kívülről csak az elkészült fájl érhető el:

  • Az elkészült fájl egy közönséges fájl a Drive-ján, a Cast beállításaiban megadott mappában, így mindaz működik rajta, amit a Drive a fájlokhoz kínál.

Minden metódus a munkaterület tulajdonosa nevében jár el, és sikeres működésnél code 1 értéket ad vissza. Az elutasítás negatív code értéket ad, és a data mezőben megmondja az okát. Minden metódus elfogad egy opcionális workspace_id értéket, hogy az Ön tulajdonában lévő, a saját otthoni munkaterületétől eltérő munkaterületen járjon el, és minden metódushoz felhasználói szintű jogosultságú munkamenet kell.

A darabok

A videó vagy podcast egy darab: egy dokumentum, amelynek azonosítója cst_ és utána 16 hexadecimális karakter. A jelenetei sc_ és utána 8 hexadecimális karakter.

  • A get_casts felsorolja a munkaterület videóit és podcastjait, a legújabbal kezdve. A listával együtt megadja a csomagot és korlátait, a hónap elkészítéseit, a mentett alapértékeket, hogy ez a szerver tud-e készíteni, és minden lépés tipikus kreditárát.
  • A get_cast egy darabot olvas be a leírásával, elemeivel, storyboardjával és állapotával. Ha a frames értéke true, minden jelenet az első képkockájának képét is magával hozza adat-URL-ként.
  • A get_cast_frame egy jelenet képét olvassa be (cast_id, scene_id) adat-URL-ként.
  • A save_cast létrehoz egy darabot, vagy módosít egyet. Elfogadja a cast_id értéket (üresen újat hoz létre), a title értéket (egy sor, legfeljebb 120 karakter), a brief értéket (fajta, cél, leírás, nyelv, hang, főszereplő, hossz, méret, megjelenés és beállítások; az ismeretlen kulcsokat eldobja. A voice_language, egy irányítópult-nyelvkód, az a nyelv, amelyen a hangok neve megadva van, amíg a language értéke auto: a podcast műsorvezetői ezeken a neveken szólítják egymást. Az irányítópult a saját nyelvére állítja, amikor darabot készít), a sources értéket (legfeljebb 20 elem) és a copy_of értéket, amely egy másik darab leírásából, elemeiből és storyboardjából indít új piszkozatot. Elutasítja, amíg forgatókönyv vagy elkészítés dolgozik a darabon.
  • A delete_cast töröl egy darabot és a képkockáit. A belőle készült fájl a Drive-ján marad.

Egy munkaterület legfeljebb 200 darabot tart. A darab elemei Drive-fájlok és -mappák, névjegyek, névjegycsoportok, AI-csevegések, tudásbázisok, pilóták, hivatkozások és jegyzetek. A csatlakozót megtartja, de még nem tudja olvasni.

A forgatókönyv és a storyboard

  • A read_cast_reference megnéz egy YouTube-videót kizárólag a stílusáért, és azt adja vissza reference néven, amit a leírás megtart belőle: a megjelenését (színek, betűtípus, sarkok, kamera, átmenetek és azok időtartama, a felirat alakja), a tempóját (másodperc egy felvételre, vágás percenként), a beszédtempóját, rövid jegyzeteket az elkészítésének módjáról, és amit a leírásnak javasol (fajta, cél, típus, forma, hossz). Az url értéket fogadja. Feladatként fut (lépések: a videó megtekintése, a stílus beolvasása), és AI krediteket használ. A darab akkor követi, ha a leírása tartalmazza a reference értéket, és a style értéke reference: a forgatókönyv az ő tempójára íródik, és az elkészítés az ő átmeneteivel vág. A videó tartalmából semmi nem marad meg.
  • A write_cast_script megírja a forgatókönyvet a leírásból és az elemekből: jeleneteket, mindegyik első képkockájával videó esetén, szólamokat podcast esetén. Elfogadja a cast_id értéket és egy opcionális, legfeljebb 600 karakteres instruction értéket. Feladatként fut (lépések: az elemek beolvasása, a forgatókönyv megírása, az első képkockák megrajzolása), és a forgatókönyvek és képek AI krediteket használnak.
  • Az edit_cast_storyboard legfeljebb 60 módosítást alkalmaz sorrendben: confirm, unconfirm, confirm_all, delete, delete_all, move és set (egy jelenet szövege, a képernyőn lévő felirata, egy kártya címsora, száma, felsorolása, idézete és elrendezése, és hogy melyik műsorvezető mondja a szólamot). A nem megfelelő alakú módosítás az egész hívást elutasítja. Visszaadja az újrarajzolt képkockákat.
  • A redo_cast_scene egy jelenetet csinál újra. A mode értéke rewrite, picture (új kép, a szöveg marad), insert (új jelenet a position helyén, 0-tól számolva) vagy kind (a jelenet tartalmának módosítása: title, card, picture, stock, screenshot, presenter vagy podcast). Az instruction legfeljebb 600 karakter. Feladatként fut, és a képek és az írás AI krediteket használnak.

Elkészítés és publikálás

  • A build_cast elkészíti a fájlt a jóváhagyott storyboardból, és elmenti a Drive-ra. Ha egy jelenet nincs jóváhagyva, elutasítja, kivéve ha a confirm_all értéke true. Feladatként fut (lépések: a hang felvétele, a képek előkészítése, a jelenetek összeillesztése, a hang keverése, mentés a Drive-ra). A hangok és képek AI krediteket használnak, és a sikeres elkészítés beleszámít a hónapba.
  • A stop_cast_build megállítja a darabon dolgozó elkészítést.
  • A publish_cast megoszt egy elkészült darabot. A way értéke link, amely bekapcsolja a hivatkozást (vagy kikapcsolja, ha az off értéke true), vagy email, amely a hivatkozást a to mezőben megadott legfeljebb 10 címre küldi, egy opcionális, legfeljebb 1000 karakteres message üzenettel. Bárki, akinek van hivatkozása, megnézheti vagy meghallgathatja, amíg a fájlt nem törlik.
  • A quick_cast gyors infografikai videót készít egy névjegyről, egy névjegycsoportról, egy AI-csevegésről vagy egy tudásbázisról: target_kind (contact, contact_group, chat vagy knowledge_base), target_id, egy opcionális target_name a címhez, és egy opcionális language, amelyet akkor használ, ha a beállításokban Auto szerepel. A beállításokban mentett alapértékeket használja. Feladatként fut (lépések: az elem beolvasása, a forgatókönyv megírása, a képkockák megrajzolása, a videó elkészítése).

Egy szerver egyszerre egy darabot készít el mindenkinek. Egy munkaterületnek legfeljebb két helye lehet ebben a sorban, egy készülő és egy várakozó, a harmadikat elutasítja.

Beállítások és csomagok

  • A save_cast_settings elmenti az új darabok és a gyorsvideók alapértékeit: language (auto vagy egy irányítópult-nyelvkód), voice és gender, voice2 és gender2 a második műsorvezetőnek, character, seconds, size (9:16, 1:1, 4:5 vagy 16:9), style, captions, music, quick_build és folder. Csak az elküldött kulcsok változnak.
  • A get_cast_plans beolvassa a csomagokat az áraikkal, funkcióikkal és jogosultságaikkal, azt a csomagot, amelyen ez a fiók van, hogy a Cast be van-e kapcsolva, és a hónapban felhasznált elkészítéseket.
  • A cast_set_plan bekapcsolja a Castot, módosítja a csomagot (a plan_id értéke cast_free, cast_starter, cast_growth vagy cast_business), vagy kikapcsolja (üres plan_id, vagy a deactivate értéke true). A kikapcsolás minden videót és podcastot megtart. Mindkét csomagmetódus elfogad egy opcionális billing_workspace_id értéket, amely csak akkor számít, ha a Cast csomagjait munkaterületenként tartják.

Mit utasít el

Az irányítópult mindegyiket szavakkal megmondja a vezérlő mellett. A metódus válaszában ezek egy negatív code, a data mezőben egy mondattal:

  • Videót és podcastot csak a munkaterület tulajdonosa készíthet benne. A nyilvános Assistant-csevegés nem.
  • A Cast ki van kapcsolva a fiókon, vagy a csomag havi elkészítéseinek száma elfogyott (az elkészítést elutasítja, a forgatókönyvet nem).
  • A hossz vagy a jelenetek száma meghaladja azt, amit a csomag enged.
  • A darabon dolgoznak. Forgatókönyv vagy elkészítés dolgozik rajta, ezért nem menthető és nem szerkeszthető, amíg be nem fejeződik vagy meg nem állítják.
  • Nincs elég AI kredit a forgatókönyv, kép vagy hang kifizetéséhez.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.