Przejdź do treści

Cast

Filmy i podcasty tworzone z Twoich plików, kontaktów i czatów.

Otwórz Cast
Sprawdzono z pulpitem dnia 20 listopada 2026

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_casts wypisuje 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_cast odczytuje jeden utwór wraz z jego założeniami (brief), elementami, storyboardem i stanem. Gdy frames ma wartość true, każda scena dodatkowo niesie obraz swojej pierwszej klatki jako data URL.
  • get_cast_frame odczytuje obraz jednej sceny (cast_id, scene_id) jako data URL.
  • save_cast tworzy utwór lub go zmienia. Przyjmuje cast_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, gdy language ma 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) i copy_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_cast usuwa 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_reference ogląda wideo z YouTube wyłącznie pod kątem stylu i zwraca to, co założenia zachowują z niego jako reference: 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ść). Przyjmuje url. 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, a style ma 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_script pisze skrypt na podstawie założeń i elementów: sceny z pierwszą klatką każdej dla wideo, kwestie dla podcastu. Przyjmuje cast_id i opcjonalne instruction do 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_storyboard stosuje do 60 zmian po kolei: confirm, unconfirm, confirm_all, delete, delete_all, move i set (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_scene robi jedną scenę od nowa. Jej mode to rewrite, picture (nowy obraz, słowa zostają), insert (nowa scena w position, licząc od 0) lub kind (zmiana tego, co scena pokazuje: title, card, picture, stock, screenshot, presenter lub podcast). instruction ma do 600 znaków. Działa jako zadanie, a obrazy i pisanie zużywają kredyty AI.

Budowanie i publikowanie

  • build_cast buduje plik z potwierdzonego storyboardu i zapisuje go na Drive. Niepotwierdzona scena powoduje odmowę, chyba że confirm_all ma 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_build zatrzymuje budowę utworu, która trwa.
  • publish_cast udostępnia zbudowany utwór. way to link, które włącza link (lub wyłącza, gdy off ma wartość true), albo email, które wysyła link do 10 adresów w to, z opcjonalną wiadomością message do 1000 znaków. Każdy, kto ma link, może oglądać lub słuchać, dopóki plik nie zostanie usunięty.
  • quick_cast robi szybkie wideo z infografiką o kontakcie, grupie kontaktów, czacie z AI lub bazie wiedzy: target_kind (contact, contact_group, chat lub knowledge_base), target_id, opcjonalne target_name jako tytuł i opcjonalne language, 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_settings zapisuje ustawienia domyślne dla nowych utworów i szybkich wideo: language (auto lub kod języka dashboardu), voice i gender, voice2 i gender2 dla drugiego gospodarza, character, seconds, size (9:16, 1:1, 4:5 lub 16:9), style, captions, music, quick_build i folder. Zmieniają się tylko te klucze, które wyślesz.
  • get_cast_plans odczytuje 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_plan włącza Cast, zmienia plan (plan_id to cast_free, cast_starter, cast_growth lub cast_business) albo go wyłącza (puste plan_id lub deactivate ustawione na true). Wyłączenie zachowuje każde wideo i podcast. Obie metody planu przyjmują opcjonalne billing_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.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026