Produções do Studio

As ferramentas de produção do Studio criam e alteram filmes que abrem no editor do Nodaro Studio, em studio.nodaro.ai. Esta página lista os parâmetros de cada ferramenta. Produções do Studio explica o ciclo de trabalho, as palavras a usar com o usuário, as operações de edição e as regras de gasto; leia essa página primeiro.

As produções do Studio são um recurso do Nodaro Cloud. Numa implantação sem elas, todas as ferramentas desta família respondem not_available. Chame list_studio_productions para verificar antes de oferecer o recurso.

Ferramentas, permissões e preços

As ferramentas que gastam créditos, e share_studio_production, que muda quem pode ver o trabalho, trazem uma marca de confirmação na definição. As ferramentas que gastam créditos aceitam client_request_id, um token de nova tentativa de 8 a 128 caracteres: envie o mesmo valor de novo depois de uma chamada que expirou, e nada é iniciado nem cobrado duas vezes.

Planejar e ler

get_studio_production_skill

Retorna o guia que um assistente lê antes de trabalhar numa produção. Ele é gerado a partir da implantação ativa.

validate_studio_plan

Verifica um plano escrito, de graça, e não salva nada. Também associa cada nome de cast aos seus próprios personagens, locais, objetos e criaturas.

Retorna: valid, errors (cada um indicando o campo dele), warnings e um summary que diz quantos nomes do elenco corresponderam à sua biblioteca. Corrija os erros e chame de novo até valid ser true.

list_studio_productions

Lista as suas produções, das mais recentes para as mais antigas: ID, nome, versão, miniatura, se ela está compartilhada e o número de cenas. As produções arquivadas ficam ocultas, como no painel.

get_studio_production

Retorna uma produção: o look do filme, o elenco, as pastas, os cortes, a lixeira, o que está em execução e as cenas na ordem da linha do tempo. Com workflows:write, ela primeiro incorpora cada job que terminou desde a última leitura; é por essa leitura que uma geração concluída chega à cena dela.

Retorna: a produção e um bloco pending que indica o que ainda está em execução. Identifique um resultado pela key, pelo ID do job ou pela URL, nunca pela posição.

plan_studio_export

Retorna as etapas ordenadas que exportariam a produção, com uma estimativa de créditos. Não inicia nem cobra nada: mostre-a ao usuário antes que ele aceite.

Criar e alterar

create_studio_production

Cria uma produção no seu próprio projeto do Studio. Ela aparece na hora no seu painel em studio.nodaro.ai. Com um plano, todas as cenas, os vínculos do elenco e o look do filme entram junto; sem plano, a produção fica vazia. Valide o plano primeiro.

import_studio_production

Adiciona as cenas de um plano a uma produção existente e inclui os novos membros no elenco. Nunca renomeia a produção nem altera o briefing ou o look dela.

edit_studio_production

Altera uma produção com um lote de operações, como renomear uma cena, reordenar a linha do tempo, selecionar um take, definir as tomadas dentro do movimento de uma cena, incluir um membro no elenco ou esvaziar a lixeira. As operações e os argumentos delas vêm de get_studio_production_skill com part: "operating".

Retorna: receipts, uma linha no passado por operação. O lote é aplicado como uma única etapa: se uma operação for recusada, a resposta indica o índice dela e nada é gravado. Um lote montado sobre uma versão um pouco mais antiga ainda é aplicado, e rebased: true indica isso.

share_studio_production

Publica a produção num link de compartilhamento ou a torna privada de novo. Qualquer pessoa com o link pode ler uma produção compartilhada, então pergunte ao usuário antes. Esta ferramenta é a única forma de mudar o compartilhamento.

clone_studio_production

Copia uma produção, sua ou compartilhada com você, para o seu projeto do Studio. A cópia começa privada e traz o grafo e todos os resultados já incorporados. Use-a antes de uma rodada de edições arriscada.

Gerar

Uma geração retorna IDs de job na hora. O resultado pronto só entra na cena dele na próxima chamada de get_studio_production; get_job e wait_for_job informam o status e não incorporam nada.

describe_studio_production

Entrega um briefing ao Diretor, que escreve cenas, elenco e looks na produção. Use-a quando o usuário tiver uma história em vez de um plano.

generate_studio_still

Gera candidatas para o quadro de uma cena, a partir do que a cena já diz: o prompt, as referências, o elenco e a direção. Gerar de novo adiciona takes; nunca substitui um take.

generate_studio_keyframe

Gera uma candidata para um quadro planejado: um quadro que o usuário revisa e aceita, diferente do quadro de uma cena. Um quadro derivado precisa de um quadro de origem aceito. Não há cotação para esta ferramenta, e dry_run: true é recusado.

Incorporar a candidata não a aceita nem inicia outro quadro. Aceite-a com edit_studio_production depois da revisão. Esta ferramenta precisa de uma implantação compatível com quadros planejados.

generate_studio_clip

Gera o movimento de uma cena a partir do quadro dela, dos quadros inicial e final e da direção.

Para refazer um take vinculado exatamente igual, chame primeiro com retake_result_key e dry_run: true e confira o preço e o inputHash. Depois, envie a mesma chamada com expected_input_hash e um novo client_request_id, sem dry_run. O retake usa as configurações originais e as imagens inicial e final do take, mesmo que o plano tenha mudado desde então. As implantações anunciam esse recurso com a capacidade operations.retakeLinkedClips.

new_studio_shot_from_frame

Pega um quadro do movimento atual de uma cena e o reaproveita. A chamada aguarda a extração e responde com a produção atualizada.

voice_studio_shot

Fala uma frase sobre uma cena, como narração. A chamada aguarda a fala e responde com a produção atualizada.

revoice_studio_clip

Substitui as vozes dentro do movimento atual de uma cena: o diálogo é interpretado de novo e mixado de volta sobre a mesma imagem.

score_studio_production

Compõe uma trilha sonora para a produção inteira a partir de uma descrição da música.