Cast
Videa a podcasty vytvořené z vašich souborů, kontaktů a chatů.
Cast dnes nemá žádné veřejné metody API. Každá jeho metoda nese příznak private, takže ji nemůže volat žádný klíč API, ani klíč s plným přístupem. Níže uvedené metody volají obrazovky Cast z přihlášené relace dashboardu. Jsou uvedeny proto, abyste věděli, co obrazovky dělají, ne jako něco, co volat z vlastního kódu.
Video nebo podcast se vytváří v dashboardu: ze stránky samotného Cast, nebo přetažením Cast na kontakt, skupinu kontaktů, AI chat či znalostní bázi pro rychlé video. Zvenčí je dosažitelný jen hotový soubor:
- Hotový soubor je běžný soubor na vašem Drive, ve složce nastavené v nastavení Cast, takže na něj funguje vše, co Drive pro soubory nabízí.
Každá metoda jedná za vlastníka pracovního prostoru a při úspěchu odpovídá code 1. Zamítnutí odpovídá záporným code a v data říká proč. Každá metoda přijímá volitelné workspace_id, aby jednala v pracovním prostoru, který vlastníte, jiném než váš domovský, a každá metoda vyžaduje relaci s úrovní oprávnění uživatele.
Díla
Video nebo podcast je dílo: jeden dokument s id, které se skládá z cst_ a 16 hexadecimálních znaků. Jeho scény mají id sc_ a 8 hexadecimálních znaků.
get_castsvypíše videa a podcasty pracovního prostoru, nejnovější první. Spolu se seznamem odpovídá tarifem a jeho limity, sestaveními tohoto měsíce, uloženými výchozími hodnotami, zda tento server umí sestavovat, a typickou cenou v kreditech za každý krok.get_castpřečte jedno dílo s jeho zadáním, položkami, storyboardem a stavem. Sframesnastaveným natruenese každá scéna také obrázek svého prvního snímku jako data URL.get_cast_framepřečte obrázek jedné scény (cast_id,scene_id) jako data URL.save_castvytvoří dílo nebo jedno změní. Přijímácast_id(prázdné vytvoří nové),title(jeden řádek, nejvýše 120 znaků),brief(druh, účel, popis, jazyk, hlas, hlavní postava, délka, velikost, vzhled a volby; klíče, které nezná, se zahodí.voice_language, kód jazyka dashboardu, je jazyk, ve kterém jsou hlasy pojmenovány, dokud jelanguageauto: moderátoři podcastu se těmito jmény oslovují. Dashboard ji nastaví na svůj vlastní jazyk, když dílo vytváří),sources(až 20 položek) acopy_of, které začne nový koncept ze zadání, položek a storyboardu jiného díla. Je zamítnuto, dokud na díle pracuje scénář nebo sestavení.delete_castsmaže dílo a jeho snímky. Soubor z něj sestavený zůstane na vašem Drive.
Pracovní prostor drží až 200 děl. Položky díla jsou soubory a složky z Drive, kontakty, skupiny kontaktů, AI chaty, znalostní báze, piloti, odkazy a poznámky. Konektor se uloží, ale zatím ho nelze číst.
Scénář a storyboard
read_cast_referencesleduje video z YouTube jen kvůli jeho stylu a jakoreferenceodpovídá, co si z něj zadání ponechá: jeho vzhled (barvy, písmo, rohy, kameru, přechody a jak dlouho trvají, tvar titulků), jeho tempo (sekundy na záběr, střihy za minutu), jeho tempo řeči, krátké poznámky o tom, jak je vytvořeno, a co to naznačuje pro zadání (druh, účel, typ, tvar, délku). Přijímáurl. Běží jako úloha (kroky: sledování videa, čtení jeho stylu) a spotřebovává AI kredity. Dílo se jím řídí, když zadání obsahujereferenceastylejereference: scénář se píše v jeho tempu a sestavení stříhá s jeho přechody. Nic z obsahu videa se neuchovává.write_cast_scriptnapíše scénář ze zadání a položek: scény s prvním snímkem každé pro video, repliky pro podcast. Přijímácast_ida volitelnéinstructiono délce až 600 znaků. Běží jako úloha (kroky: čtení vašich položek, psaní scénáře, kreslení prvních snímků) a scénáře i obrázky spotřebovávají AI kredity.edit_cast_storyboardprovede v pořadí až 60 změn:confirm,unconfirm,confirm_all,delete,delete_all,moveaset(slova scény, její titulek na obrazovce, nadpis karty, údaj, odrážky, citát a rozvržení a který moderátor repliku říká). Změna, která není správně utvářená, zamítne celé volání. Odpovídá snímky, které nakreslilo znovu.redo_cast_scenepředělá jednu scénu. Jejímodejerewrite,picture(nový obrázek, slova zůstanou),insert(nová scéna naposition, počítáno od 0) nebokind(změní, co scéna ukazuje:title,card,picture,stock,screenshot,presenternebopodcast).instructionmá až 600 znaků. Běží jako úloha a obrázky i psaní spotřebovávají AI kredity.
Sestavení a publikování
build_castsestaví soubor z potvrzeného storyboardu a uloží jej na Drive. Nepotvrzená scéna jej zamítne, pokud neníconfirm_alltrue. Běží jako úloha (kroky: nahrávání hlasu, příprava obrázků, skládání scén, mixování zvuku, ukládání na váš Drive). Hlasy a obrázky spotřebovávají AI kredity a úspěšné sestavení se počítá do měsíce.stop_cast_buildzastaví sestavení, které na díle běží.publish_castsdílí sestavené dílo.wayjelink, což zapne odkaz (nebo jej vypne, soffnastaveným natrue), neboemail, což pošle odkaz až na 10 adres vto, s volitelnoumessageo délce až 1000 znaků. Kdokoli s odkazem se může dívat nebo poslouchat, dokud se soubor nesmaže.quick_castvytvoří rychlé infografické video o kontaktu, skupině kontaktů, AI chatu nebo znalostní bázi:target_kind(contact,contact_group,chatneboknowledge_base),target_id, volitelnétarget_namepro název a volitelnýlanguage, použitý, když nastavení říká Auto. Používá výchozí hodnoty uložené v nastavení. Běží jako úloha (kroky: čtení položky, psaní scénáře, kreslení snímků, sestavení videa).
Jeden server sestavuje pro všechny jedno dílo najednou. Pracovní prostor drží v této frontě nejvýše dvě místa, jedno sestavující a jedno čekající, a třetí je zamítnuto.
Nastavení a tarify
save_cast_settingsuloží výchozí hodnoty pro nová díla a pro rychlá videa:language(autonebo kód jazyka dashboardu),voiceagender,voice2agender2pro druhého moderátora,character,seconds,size(9:16,1:1,4:5nebo16:9),style,captions,music,quick_buildafolder. Mění se jen klíče, které pošlete.get_cast_planspřečte tarify s jejich cenami, funkcemi a nároky, tarif, na kterém tento účet je, zda je Cast zapnutý, a sestavení použitá tento měsíc.cast_set_planzapne Cast, změní tarif (plan_idjecast_free,cast_starter,cast_growthnebocast_business) nebo jej vypne (prázdnéplan_idnebodeactivatenastavené natrue). Vypnutí ponechá všechna videa a podcasty. Obě metody tarifu přijímají volitelnébilling_workspace_id, které má význam až ve chvíli, kdy se tarify Cast drží podle pracovního prostoru.
Co se zamítá
Dashboard každé z těchto věcí říká slovy vedle ovládacího prvku. V odpovědi metody je to záporný code s větou v data:
- Videa a podcasty v pracovním prostoru může vytvářet jen jeho vlastník. Veřejný chat Asistenta nemůže.
- Cast je pro účet vypnutý, nebo je počet sestavení tarifu v měsíci vyčerpán (sestavení se zamítne, scénář ne).
- Délka nebo počet scén je nad rámec toho, co tarif dovoluje.
- Na díle se pracuje. Pracuje na něm scénář nebo sestavení, takže jej nelze uložit ani upravit, dokud neskončí nebo se nezastaví.
- Není dost AI kreditů na zaplacení scénáře, obrázku nebo hlasu.