Saltar para o conteúdo

Cast

Vídeos e podcasts feitos a partir dos seus próprios ficheiros, contactos e chats.

Abrir Cast
Verificado com o painel em 20 de novembro de 2026

O Cast não tem hoje métodos de API públicos. Todos os métodos que tem levam a marca private, por isso nenhuma chave de API pode chamar nenhum, nem mesmo uma chave com acesso total. Os métodos abaixo são os que os ecrãs do Cast chamam, a partir de uma sessão iniciada no dashboard. Estão listados para saber o que os ecrãs fazem, não como algo para chamar a partir do seu próprio código.

Um vídeo ou um podcast é criado no dashboard: a partir da página do próprio Cast, ou arrastando o Cast para um contacto, um grupo de contactos, uma conversa de IA ou uma base de conhecimento para um vídeo rápido. De fora, só o ficheiro final está ao seu alcance:

  • Um ficheiro final é um ficheiro normal no seu Drive, na pasta definida nas definições do Cast, por isso tudo o que o Drive oferece para ficheiros funciona nele.

Cada método atua em nome do proprietário do espaço de trabalho e responde code 1 quando funciona. Uma recusa responde com um code negativo e explica o motivo em data. Todos os métodos aceitam um workspace_id opcional, para atuar num espaço de trabalho seu que não seja o principal, e todos precisam de uma sessão com autorização de utilizador.

As peças

Um vídeo ou um podcast é uma peça: um documento com um id que se lê cst_ seguido de 16 caracteres hexadecimais. As suas cenas lêem-se sc_ seguido de 8 caracteres hexadecimais.

  • get_casts lista os vídeos e podcasts do espaço de trabalho, dos mais recentes para os mais antigos. Com a lista responde o plano e os seus limites, as construções deste mês, as predefinições guardadas, se este servidor consegue criar, e um preço típico em créditos para cada passo.
  • get_cast lê uma peça com o seu briefing, itens, storyboard e estado. Com frames definido como true, cada cena traz também a imagem do seu primeiro fotograma como um URL de dados.
  • get_cast_frame lê a imagem de uma cena (cast_id, scene_id) como um URL de dados.
  • save_cast cria uma peça, ou altera uma. Recebe cast_id (vazio cria uma nova), title (uma linha, até 120 caracteres), brief (tipo, finalidade, descrição, idioma, voz, personagem principal, duração, tamanho, estilo e opções; as chaves que não conhece são descartadas. voice_language, um código de idioma do dashboard, é o idioma em que as vozes são nomeadas enquanto language for auto: os apresentadores de um podcast tratam-se por esses nomes. O dashboard define-o com o seu próprio idioma quando cria uma peça), sources (até 20 itens) e copy_of, que inicia um novo rascunho a partir do briefing, dos itens e do storyboard de outra peça. É recusado enquanto um guião ou uma construção estiver a trabalhar na peça.
  • delete_cast elimina uma peça e os seus fotogramas. O ficheiro criado a partir dela fica no seu Drive.

Um espaço de trabalho mantém até 200 peças. Os itens de uma peça são ficheiros e pastas do Drive, contactos, grupos de contactos, conversas de IA, bases de conhecimento, pilotos, ligações e notas. Um conector é guardado mas ainda não pode ser lido.

O guião e o storyboard

  • read_cast_reference vê um vídeo do YouTube só pelo seu estilo e responde o que um briefing guarda dele como reference: o seu aspeto (cores, tipo de letra, cantos, câmara, transições e quanto duram, forma das legendas), o seu ritmo (segundos por plano, cortes por minuto), a sua velocidade de fala, notas curtas sobre como é feito, e o que sugere para o briefing (tipo, finalidade, formato, forma, duração). Recebe url. Corre como uma tarefa (passos: ver o vídeo, ler o seu estilo) e usa créditos de IA. Uma peça segue-o quando o seu briefing tem a reference e style é reference: o guião é escrito ao seu ritmo e a construção corta com as suas transições. Nada do conteúdo do vídeo é guardado.
  • write_cast_script escreve o guião a partir do briefing e dos itens: cenas com o primeiro fotograma de cada uma para um vídeo, intervenções para um podcast. Recebe cast_id e uma instruction opcional de até 600 caracteres. Corre como uma tarefa (passos: ler os seus itens, escrever o guião, desenhar os primeiros fotogramas), e os guiões e as imagens usam créditos de IA.
  • edit_cast_storyboard aplica até 60 alterações por ordem: confirm, unconfirm, confirm_all, delete, delete_all, move e set (as palavras de uma cena, a sua legenda no ecrã, o título, o número, os pontos, a citação e a disposição de um cartão, e qual apresentador diz uma intervenção). Uma alteração mal formada recusa a chamada inteira. Responde com os fotogramas que desenhou de novo.
  • redo_cast_scene refaz uma cena. O seu mode é rewrite, picture (uma imagem nova, mantendo as palavras), insert (uma nova cena em position, contando a partir de 0) ou kind (muda o que a cena mostra: title, card, picture, stock, screenshot, presenter ou podcast). instruction tem até 600 caracteres. Corre como uma tarefa, e as imagens e a escrita usam créditos de IA.

Criar e publicar

  • build_cast cria o ficheiro a partir do storyboard confirmado e guarda-o no Drive. Uma cena que não esteja confirmada recusa-o, a menos que confirm_all seja true. Corre como uma tarefa (passos: gravar a voz, preparar as imagens, juntar as cenas, misturar o som, guardar no seu Drive). As vozes e as imagens usam créditos de IA, e uma construção bem-sucedida conta para o mês.
  • stop_cast_build pára a construção em curso numa peça.
  • publish_cast partilha uma peça criada. way é link, que liga a ligação (ou desliga, com off definido como true), ou email, que envia a ligação a até 10 endereços em to, com uma message opcional de até 1000 caracteres. Qualquer pessoa com a ligação pode ver ou ouvir até o ficheiro ser eliminado.
  • quick_cast cria um vídeo infográfico rápido sobre um contacto, um grupo de contactos, uma conversa de IA ou uma base de conhecimento: target_kind (contact, contact_group, chat ou knowledge_base), target_id, um target_name opcional para o título e um language opcional usado quando as definições dizem Automático. Usa as predefinições guardadas nas definições. Corre como uma tarefa (passos: ler o item, escrever o guião, desenhar os fotogramas, criar o vídeo).

Um servidor cria uma peça de cada vez para toda a gente. Um espaço de trabalho tem no máximo dois lugares nessa fila, um em construção e um em espera, e um terceiro é recusado.

Definições e planos

  • save_cast_settings guarda as predefinições para novas peças e para vídeos rápidos: language (auto ou um código de idioma do dashboard), voice e gender, voice2 e gender2 para o segundo apresentador, character, seconds, size (9:16, 1:1, 4:5 ou 16:9), style, captions, music, quick_build e folder. Só mudam as chaves que enviar.
  • get_cast_plans lê os planos com os seus preços, funcionalidades e direitos, o plano em que esta conta está, se o Cast está ligado e as construções usadas este mês.
  • cast_set_plan liga o Cast, altera o plano (plan_id é cast_free, cast_starter, cast_growth ou cast_business), ou desliga-o (um plan_id vazio, ou deactivate definido como true). Desligar mantém todos os vídeos e podcasts. Ambos os métodos de plano aceitam um billing_workspace_id opcional, que só importa quando os planos do Cast forem mantidos por espaço de trabalho.

O que é recusado

O dashboard diz cada um destes por palavras junto ao controlo. Na resposta do método são um code negativo com uma frase em data:

  • Só o proprietário de um espaço de trabalho pode criar vídeos e podcasts nele. Uma conversa de um Assistente público não pode.
  • O Cast está desligado para a conta, ou o número de construções do mês do plano está esgotado (uma construção é recusada, um guião não).
  • A duração, ou o número de cenas, ultrapassa o que o plano permite.
  • A peça está a ser trabalhada. Um guião ou uma construção está a trabalhar nela, por isso não pode ser guardada nem editada até terminar ou ser parada.
  • Não há créditos de IA suficientes para pagar um guião, uma imagem ou uma voz.

Que tal está este guia?

Última atualização em 18 de novembro de 2026