Cast
Vídeos e podcasts feitos a partir dos seus próprios ficheiros, contactos e chats.
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_castslista 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_castlê uma peça com o seu briefing, itens, storyboard e estado. Comframesdefinido comotrue, cada cena traz também a imagem do seu primeiro fotograma como um URL de dados.get_cast_framelê a imagem de uma cena (cast_id,scene_id) como um URL de dados.save_castcria uma peça, ou altera uma. Recebecast_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 enquantolanguageforauto: 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) ecopy_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_castelimina 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_referencevê um vídeo do YouTube só pelo seu estilo e responde o que um briefing guarda dele comoreference: 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). Recebeurl. 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 areferenceestyleé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_scriptescreve 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. Recebecast_ide umainstructionopcional 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_storyboardaplica até 60 alterações por ordem:confirm,unconfirm,confirm_all,delete,delete_all,moveeset(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_scenerefaz uma cena. O seumodeérewrite,picture(uma imagem nova, mantendo as palavras),insert(uma nova cena emposition, contando a partir de 0) oukind(muda o que a cena mostra:title,card,picture,stock,screenshot,presenteroupodcast).instructiontem até 600 caracteres. Corre como uma tarefa, e as imagens e a escrita usam créditos de IA.
Criar e publicar
build_castcria o ficheiro a partir do storyboard confirmado e guarda-o no Drive. Uma cena que não esteja confirmada recusa-o, a menos queconfirm_allsejatrue. 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_buildpára a construção em curso numa peça.publish_castpartilha uma peça criada.wayélink, que liga a ligação (ou desliga, comoffdefinido comotrue), ouemail, que envia a ligação a até 10 endereços emto, com umamessageopcional de até 1000 caracteres. Qualquer pessoa com a ligação pode ver ou ouvir até o ficheiro ser eliminado.quick_castcria 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,chatouknowledge_base),target_id, umtarget_nameopcional para o título e umlanguageopcional 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_settingsguarda as predefinições para novas peças e para vídeos rápidos:language(autoou um código de idioma do dashboard),voiceegender,voice2egender2para o segundo apresentador,character,seconds,size(9:16,1:1,4:5ou16:9),style,captions,music,quick_buildefolder. Só mudam as chaves que enviar.get_cast_planslê 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_planliga o Cast, altera o plano (plan_idécast_free,cast_starter,cast_growthoucast_business), ou desliga-o (umplan_idvazio, oudeactivatedefinido comotrue). Desligar mantém todos os vídeos e podcasts. Ambos os métodos de plano aceitam umbilling_workspace_idopcional, 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.