Cast
Filmy i podcasty tworzone z Twoich plików, kontaktów i czatów.
Cast nie ma dziś publicznych metod API. Każda jego metoda ma flagę private, więc żaden klucz API nie może jej wywołać, nawet klucz z pełnym dostępem. Poniższe metody wywołują ekrany Cast z sesji zalogowanego dashboardu. Podajemy je, żebyś wiedział, co robią ekrany, a nie po to, by wywoływać je z własnego kodu.
Wideo lub podcast powstaje w dashboardzie: na stronie samego Cast albo przez przeciągnięcie Cast na kontakt, grupę kontaktów, czat z AI lub bazę wiedzy, żeby szybko zrobić wideo. Z zewnątrz dostępny jest tylko gotowy plik:
- Gotowy plik to zwykły plik w Twoim Drive, w folderze ustawionym w ustawieniach Cast, więc działa na nim wszystko, co Drive oferuje dla plików.
Każda metoda działa w imieniu właściciela przestrzeni roboczej i odpowiada code równym 1, gdy się uda. Odmowa zwraca ujemny code i podaje powód w data. Każda metoda przyjmuje opcjonalne workspace_id, aby działać w innej przestrzeni roboczej, którą posiadasz, niż główna, i każda wymaga sesji z uprawnieniami użytkownika (user clearance).
Utwory
Wideo lub podcast to utwór: jeden dokument z identyfikatorem, który wygląda jak cst_ i 16 znaków szesnastkowych. Jego sceny wyglądają jak sc_ i 8 znaków szesnastkowych.
get_castswypisuje wideo i podcasty przestrzeni roboczej, od najnowszych. Razem z listą zwraca plan i jego limity, budowy w tym miesiącu, zapisane ustawienia domyślne, informację, czy ten serwer może budować, oraz typową cenę w kredytach dla każdego kroku.get_castodczytuje jeden utwór wraz z jego założeniami (brief), elementami, storyboardem i stanem. Gdyframesma wartośćtrue, każda scena dodatkowo niesie obraz swojej pierwszej klatki jako data URL.get_cast_frameodczytuje obraz jednej sceny (cast_id,scene_id) jako data URL.save_casttworzy utwór lub go zmienia. Przyjmujecast_id(puste tworzy nowy),title(jedna linia, do 120 znaków),brief(rodzaj, cel, opis, język, głos, główna postać, długość, rozmiar, wygląd i opcje; nieznane klucze są odrzucane.voice_language, kod języka dashboardu, to język, w którym nazwane są głosy, gdylanguagema wartośćauto: gospodarze podcastu zwracają się do siebie tymi imionami. Dashboard ustawia go na swój własny język, gdy tworzy utwór),sources(do 20 elementów) icopy_of, które zaczyna nowy szkic od założeń, elementów i storyboardu innego utworu. Jest odrzucane, gdy nad utworem pracuje skrypt lub budowa.delete_castusuwa utwór i jego klatki. Plik zbudowany z niego zostaje w Twoim Drive.
Przestrzeń robocza przechowuje do 200 utworów. Elementami utworu są pliki i foldery Drive, kontakty, grupy kontaktów, czaty z AI, bazy wiedzy, piloci, linki i notatki. Konektor jest zapamiętywany, ale nie można go jeszcze odczytać.
Skrypt i storyboard
read_cast_referenceogląda wideo z YouTube wyłącznie pod kątem stylu i zwraca to, co założenia zachowują z niego jakoreference: wygląd (kolory, krój pisma, rogi, kamera, przejścia i ich czas trwania, kształt napisów), tempo (sekundy na ujęcie, cięcia na minutę), tempo mówienia, krótkie uwagi o tym, jak powstało, i to, co sugeruje dla założeń (rodzaj, cel, typ, kształt, długość). Przyjmujeurl. Działa jako zadanie (kroki: oglądanie wideo, czytanie jego stylu) i zużywa kredyty AI. Utwór podąża za nim, gdy jego założenia zawierająreference, astylema wartośćreference: skrypt jest pisany w jego tempie, a budowa tnie z jego przejściami. Nic z treści wideo nie jest zachowywane.write_cast_scriptpisze skrypt na podstawie założeń i elementów: sceny z pierwszą klatką każdej dla wideo, kwestie dla podcastu. Przyjmujecast_idi opcjonalneinstructiondo 600 znaków. Działa jako zadanie (kroki: czytanie Twoich elementów, pisanie skryptu, rysowanie pierwszych klatek), a skrypty i obrazy zużywają kredyty AI.edit_cast_storyboardstosuje do 60 zmian po kolei:confirm,unconfirm,confirm_all,delete,delete_all,moveiset(słowa sceny, jej napis na ekranie, nagłówek karty, liczba, punkty, cytat i układ oraz to, który gospodarz wypowiada daną kwestię). Zmiana w niepoprawnej postaci odrzuca całe wywołanie. Odpowiedź zawiera ponownie narysowane klatki.redo_cast_scenerobi jedną scenę od nowa. Jejmodetorewrite,picture(nowy obraz, słowa zostają),insert(nowa scena wposition, licząc od 0) lubkind(zmiana tego, co scena pokazuje:title,card,picture,stock,screenshot,presenterlubpodcast).instructionma do 600 znaków. Działa jako zadanie, a obrazy i pisanie zużywają kredyty AI.
Budowanie i publikowanie
build_castbuduje plik z potwierdzonego storyboardu i zapisuje go na Drive. Niepotwierdzona scena powoduje odmowę, chyba żeconfirm_allma wartośćtrue. Działa jako zadanie (kroki: nagrywanie głosu, przygotowanie obrazów, składanie scen, miksowanie dźwięku, zapis na Twoim Drive). Głosy i obrazy zużywają kredyty AI, a udana budowa wlicza się do limitu miesiąca.stop_cast_buildzatrzymuje budowę utworu, która trwa.publish_castudostępnia zbudowany utwór.waytolink, które włącza link (lub wyłącza, gdyoffma wartośćtrue), alboemail, które wysyła link do 10 adresów wto, z opcjonalną wiadomościąmessagedo 1000 znaków. Każdy, kto ma link, może oglądać lub słuchać, dopóki plik nie zostanie usunięty.quick_castrobi szybkie wideo z infografiką o kontakcie, grupie kontaktów, czacie z AI lub bazie wiedzy:target_kind(contact,contact_group,chatlubknowledge_base),target_id, opcjonalnetarget_namejako tytuł i opcjonalnelanguage, używane, gdy ustawienia mówią Auto. Korzysta z ustawień domyślnych zapisanych w ustawieniach. Działa jako zadanie (kroki: czytanie elementu, pisanie skryptu, rysowanie klatek, budowanie wideo).
Jeden serwer buduje naraz jeden utwór dla wszystkich. Przestrzeń robocza zajmuje w tej kolejce najwyżej dwa miejsca, jedno w budowie i jedno oczekujące, a trzecie jest odrzucane.
Ustawienia i plany
save_cast_settingszapisuje ustawienia domyślne dla nowych utworów i szybkich wideo:language(autolub kod języka dashboardu),voiceigender,voice2igender2dla drugiego gospodarza,character,seconds,size(9:16,1:1,4:5lub16:9),style,captions,music,quick_buildifolder. Zmieniają się tylko te klucze, które wyślesz.get_cast_plansodczytuje plany wraz z cenami, funkcjami i uprawnieniami, plan, na którym jest to konto, informację, czy Cast jest włączony, oraz budowy wykorzystane w tym miesiącu.cast_set_planwłącza Cast, zmienia plan (plan_idtocast_free,cast_starter,cast_growthlubcast_business) albo go wyłącza (pusteplan_idlubdeactivateustawione natrue). Wyłączenie zachowuje każde wideo i podcast. Obie metody planu przyjmują opcjonalnebilling_workspace_id, które ma znaczenie dopiero wtedy, gdy plany Cast są przypisane do przestrzeni roboczych.
Co jest odrzucane
Dashboard mówi o każdej z tych rzeczy słowami obok kontrolki. W odpowiedzi metody jest to ujemny code ze zdaniem w data:
- Tylko właściciel przestrzeni roboczej może w niej robić wideo i podcasty. Publiczny czat Assistant nie może.
- Cast jest wyłączony dla konta albo wykorzystano liczbę budów w miesiącu przewidzianą w planie (budowa jest odrzucana, skrypt nie).
- Długość lub liczba scen przekracza to, na co pozwala plan.
- Nad utworem trwa praca. Pracuje nad nim skrypt lub budowa, więc nie można go zapisać ani edytować, dopóki się nie skończy lub nie zostanie zatrzymana.
- Brakuje kredytów AI na skrypt, obraz lub głos.