Comandos de entidades
Crie, pesquise e treine personagens, locais e objetos pela CLI do Nodaro, aprove suas imagens principais e adicione variações e clipes de movimento.
Os comandos de entidades da CLI do Nodaro gerenciam personagens, locais e objetos: as identidades reutilizáveis que mantêm uma pessoa, um lugar ou um adereço iguais em todas as gerações. Cada entidade tem uma imagem principal que você gera e aprova, e variações e clipes de movimento que você adiciona depois. As mesmas entidades aparecem nos nós Personagem, Local e Objeto/adereço do editor.
Como uma entidade é criada
Criar o registro
create salva o nome, a descrição e o estilo da entidade.
Gerar candidatos
generate cria 1, 2 ou 4 candidatos a imagem principal. Adicione --watch para aguardar por eles.
Aprovar um candidato
approve-portrait (personagens) ou approve-main-image (locais e objetos) define a imagem principal a partir da tarefa concluída de um candidato. Em seguida, o Nodaro escreve a descrição da entidade a partir da imagem.
Adicionar variações e movimento
generate-asset adiciona uma variação, como uma expressão ou uma estação. generate-motion anima a imagem principal em um clipe curto.
Cada geração custa créditos, como o nó correspondente no editor. Veja Personagens consistentes para entender como as entidades mantêm as identidades estáveis.
Personagens
nodaro characters list [--project <id>] [--archived] [--search <words> | --q <words>] [--limit <n>] [--json]
nodaro characters get <id>
nodaro characters create --name <name> [--description "..."] [--gender <gender>] [--style realistic|anime|3d-pixar|illustration] [--base-outfit "..."] [--seed-prompt "..."] [--node-id <id>] [--project <id>]
nodaro characters update <id> [--name <name>] [--description "..."] [--gender <gender>] [--style realistic|anime|3d-pixar|illustration] [--base-outfit "..."] [--seed-prompt "..."]
nodaro characters delete <id>
nodaro characters restore <id>
nodaro characters duplicate <id> [--node-id <id>] [--project <id>]
nodaro characters usage <id>
nodaro characters generate <id> [--seed-prompt "..."] [--description "..."] [--name <name>] [--count 1|2|4] [--provider <p>] [--watch]
nodaro characters generate-asset <id> --asset-type expressions|poses|lighting|angles|headAngles|bodyAngles|custom --variant <name> [--user-prompt "..."] [--description "..."] [--column <col>] [--attach-name <name>] [--provider <p>] [--watch]
nodaro characters generate-motion <id> --motion-prompt "..." [--attach-name <name>] [--description "..."] [--motion-description "..."] [--provider <p>] [--watch]
nodaro characters approve-portrait <id> --job <jobId>
nodaro characters recaption <id>
nodaro characters train <id> [--image <url> ...] [--watch] [--poll-interval <ms>] [--json]
nodaro characters training <id> [--watch] [--poll-interval <ms>] [--json]
nodaro characters delete-lora <id> [--json]| Comando | O que faz |
|---|---|
list | Lista seus personagens, ou os arquivados com --archived. --project limita a lista a um projeto. --search ou --q mantém os personagens cujo nome ou descrição contém todas as palavras, até 5 palavras, sem diferenciar maiúsculas de minúsculas. Cada palavra é buscada como está escrita, sem curingas. |
delete | Arquiva o personagem. restore o traz de volta. |
duplicate | Copia o personagem para um novo registro. |
usage | Lista os workflows que usam o personagem. |
generate | Cria 1, 2 ou 4 candidatos a retrato. |
approve-portrait | Define o retrato a partir da tarefa concluída de um candidato e depois escreve a descrição do personagem a partir dele. |
generate-asset | Cria uma variação: uma expressão, uma pose, uma iluminação, um ângulo, um ângulo da cabeça, um ângulo do corpo ou uma variação personalizada. |
generate-motion | Anima o retrato em um clipe de movimento. |
recaption | Reescreve a descrição a partir do retrato atual. |
train | Inicia um treinamento de alta fidelidade do personagem, no Nodaro Cloud. Repita --image para treinar só com essas imagens, no mínimo 4. --watch acompanha a tarefa do treinamento. |
training | Mostra o status do treinamento: untrained, queued, training, succeeded, failed ou cancelled. Com --watch, ele sai com 0 em caso de sucesso, 2 quando o treinamento falhou ou não pôde começar, e 130 quando foi cancelado ou removido. |
delete-lora | Remove o modelo treinado. Cancela um treinamento em andamento, com reembolso. Não pode ser desfeito. |
Um treinamento custa 1.650 créditos, leva cerca de 15 minutos e é reembolsado se falhar. Treinar de novo custa o preço inteiro outra vez. Veja Treinamento de personagem.
Locais
nodaro locations list [--archived] [--search <words> | --q <words>] [--json]
nodaro locations get <id> [--json]
nodaro locations create <name> --node-id <id> [--description "..."] [--category indoor|outdoor|urban|nature|fantasy|sci-fi|historical|futuristic|other] [--style realistic|anime|3d-pixar|illustration] [--project <id>] [--json]
nodaro locations update <id> [--name <name>] [--description "..."] [--category <category>] [--style <style>] [--style-lock true|false] [--canonical-description "..."] [--expected-updated-at <iso>] [--json]
nodaro locations delete <id> [--json]
nodaro locations restore <id> [--json]
nodaro locations generate --name <name> [--description "..."] [--user-prompt "..."] [--category <category>] [--style <style>] [--provider <p>] [--count 1|2|4] [--attach-to-location-id <id>] [--watch] [--json]
nodaro locations generate-asset <id> --asset-type timeOfDay|weather|seasons|angles|lighting|custom --variant <name> [--user-prompt "..."] [--description "..."] [--column <col>] [--attach-name <name>] [--provider <p>] [--watch] [--json]
nodaro locations generate-motion --name <name> --motion-prompt "..." --source-image-url <url> [--provider kling|kling-turbo|kling-3.0|wan-i2v|wan-2.7-i2v|seedance-2] [--style realistic|anime|3d-pixar|illustration] [--canonical-description "..."] [--attach-to-location-id <id>] [--attach-name <name>] [--aspect-ratio 1:1|3:4|16:9|9:16] [--watch] [--json]
nodaro locations approve-main-image <id> --candidate-job-id <jobId> [--json]
nodaro locations recaption <id> [--json]list --searchou--qmantém os locais cujo nome ou descrição contém todas as palavras, como nos personagens.generatecria candidatos a plano de estabelecimento. Com--attach-to-location-ide uma contagem de 1, o resultado vira a imagem principal do local quando a tarefa termina. Com mais candidatos, escolha um comapprove-main-image.generate-assetcria uma variação: uma hora do dia, uma condição do tempo, uma estação, um ângulo, uma iluminação ou uma variação personalizada.generate-motionanima uma imagem de origem em um clipe, com um dos modelos de vídeo listados.--style-lockdefine se as gerações de variações ficam ancoradas no estilo canônico do local.--expected-updated-atimpede que uma atualização sobrescreva uma alteração mais recente. Se o registro mudou depois desse horário, a atualização é recusada comconcurrent_modification; leia o registro de novo e tente outra vez.
Objetos
nodaro objects list [--project <id>] [--archived] [--search <words> | --q <words>] [--json]
nodaro objects get <id> [--json]
nodaro objects create <name> --node-id <id> [--description "..."] [--category furniture|vehicle|weapon|food|clothing|electronics|nature|tool|animal|other] [--style realistic|anime|3d-pixar|illustration] [--project <id>] [--json]
nodaro objects update <id> [--name <name>] [--description "..."] [--category <category>] [--style <style>] [--style-lock true|false] [--canonical-description "..."] [--expected-updated-at <iso>] [--json]
nodaro objects delete <id> [--permanent] [--json]
nodaro objects restore <id> [--json]
nodaro objects generate --name <name> [--description "..."] [--user-prompt "..."] [--category <category>] [--style <style>] [--provider <p>] [--count 1|2|4] [--attach-to-object-id <id>] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects generate-asset --asset-type angles|materials|variations|motion|custom --variant <name> --attach-to-object-id <id> [--attach-to-column <col>] [--name <name>] [--description "..."] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects generate-motion --name <name> --motion-prompt "..." --source-image-url <url> [--provider kling-turbo|kling|kling-3.0|minimax|hailuo-2.3|wan-i2v|seedance|bytedance-lite] [--style realistic|anime|3d-pixar|illustration] [--canonical-description "..."] [--attach-to-object-id <id>] [--attach-name <name>] [--aspect-ratio 1:1|3:4|16:9|9:16|4:3] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects approve-main-image <id> --candidate-job-id <jobId> [--expected-updated-at <iso>] [--json]
nodaro objects recaption <id> [--json]list --searchou--qmantém os objetos cujo nome ou descrição contém todas as palavras, como nos personagens.deletearquiva o objeto.delete --permanentapaga um objeto que já está arquivado.restoretraz de volta um objeto arquivado.generatecria 1, 2 ou 4 candidatos a imagem principal. Com--attach-to-object-ide uma contagem de 1, o resultado vira a imagem principal do objeto quando a tarefa termina.generate-assetcria uma variação, vinculada ao objeto que você indicar: um ângulo, um material, uma variação, um movimento ou uma variação personalizada.generate-motionanima a imagem principal do objeto em um clipe. O modelo padrão ékling-turbo, e a proporção padrão é1:1.
Exemplo: um personagem do início ao fim
# 1. Create the character
nodaro characters create --name Kira --description "young protagonist with auburn hair" \
--style realistic --seed-prompt "kira portrait, warm natural lighting"
# 2. Generate four portrait candidates and wait for them
nodaro characters generate <characterId> --count 4 --watch
# 3. Approve the candidate you like
nodaro characters approve-portrait <characterId> --job <candidateJobId>
# 4. Add a smiling expression
nodaro characters generate-asset <characterId> --asset-type expressions --variant smile --watchPerguntas frequentes
Como crio um personagem com retrato pela CLI?
Crie o registro com nodaro characters create, gere candidatos a retrato com nodaro characters generate e --count 4, e depois aprove o que você preferir com nodaro characters approve-portrait e o id da tarefa do candidato.
Um personagem excluído some para sempre?
Não. O comando delete arquiva um personagem, um local ou um objeto, e o comando restore o traz de volta. Só os objetos podem ser apagados de vez, com delete --permanent em um objeto que já está arquivado.
O que é uma variação de uma entidade?
Uma variação é uma imagem extra da mesma entidade, como uma expressão ou uma pose de um personagem, uma hora do dia ou uma estação de um local, ou um material de um objeto. Gere uma variação com o comando generate-asset.
Como treino um personagem pela CLI?
Execute nodaro characters train com o id do personagem e --watch, no Nodaro Cloud. Um treinamento custa 1.650 créditos, leva cerca de 15 minutos e é reembolsado se falhar.
O que o recaption faz?
Ele reescreve a descrição da entidade a partir da imagem principal atual. Aprovar um retrato ou uma imagem principal já faz isso, então execute recaption só quando essa descrição tiver falhado ou a imagem tiver mudado.
Páginas relacionadas
Comandos
Personagens consistentes
Personagem
Personagens
Saída e códigos de saída
Última atualização
Saída e códigos de saída
Leia a saída da CLI do Nodaro em tabela ou JSON, acompanhe execuções até o fim com --watch e trate nos scripts os códigos de falha, cancelamento e revisão.
Comandos de mídia e voz
Troque vozes, legende vídeos, processe áudio, planeje edições e enxugue podcasts, com capítulos e clipes, usando os comandos voice, media, audio e edit da CLI.