Galeria e mídias
Num assistente de IA, navegue pela galeria e pelos uploads do Nodaro, mostre um resultado no chat, leia uma tarefa, acompanhe execuções e marque favoritos.
As ferramentas de galeria e mídias permitem que um assistente encontre, mostre e reutilize o que você já fez no Nodaro. browse_gallery e browse_uploads mostram os seus resultados e os seus uploads numa grade, get_asset e display_asset buscam ou mostram um resultado, get_app_run acompanha uma execução de workflow ou de app, e list_favorites e favorite_asset gerenciam os seus favoritos. Nenhuma delas custa créditos.
browse_gallery
Mostra a sua galeria como uma grade interativa de miniaturas. Você pode clicar num item para vê-lo, copiá-lo ou usá-lo na próxima edição. Use-a quando o usuário quiser ver o próprio trabalho; use list_jobs quando o assistente só precisar dos dados.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
scope | string | mine (padrão) para a sua própria biblioteca, ou public para resultados públicos recentes de outros usuários. |
kinds | array | Tipos de mídia a incluir: qualquer combinação de image, video e audio. Padrão: ["image", "video"]. |
kind | string | Um único tipo de mídia: image, video ou audio. |
query | string | Palavras a buscar nos prompts, com até 200 caracteres, por exemplo rabbit. Cada palavra precisa aparecer no prompt, sem diferenciar maiúsculas de minúsculas. |
limit | integer | De 1 a 200. Padrão: 50. |
cursor | string | O next_cursor da página anterior. |
Retorna: a grade, nos clientes que exibem MCP Apps, e os itens com um next_cursor como dados.
O escopo público mostra o que a galeria pública da web mostra, com a mesma moderação. Por isso, uma página pode ter menos itens que limit: continue seguindo o next_cursor até ele não aparecer mais.
Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), o escopo público não lista nada e responde (no items). A sua própria galeria não muda.
A sua própria galeria também lista as suas renderizações do Aplicar EDL: uma renderização de vídeo em video e uma renderização de áudio em audio. Uma renderização feita com qualidade de Prévia traz preview: true, e a linha de texto dela diz (preview). O escopo público nunca lista uma renderização do Aplicar EDL.
browse_uploads
Mostra os arquivos que você enviou, e não os resultados que o Nodaro gerou. Use-a para escolher um upload anterior como entrada de uma nova geração. O botão Use da grade devolve o ID do arquivo para o chat.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
kind | string | image, video ou audio. Omita-o para incluir todos os uploads. |
search | string | Palavras a buscar nos nomes dos arquivos, com até 200 caracteres. Cada palavra precisa aparecer no nome do arquivo, sem diferenciar maiúsculas de minúsculas. |
limit | integer | De 1 a 100. Padrão: 40. |
cursor | string | O nextCursor da página anterior. |
Retorna: os uploads com as URLs e os IDs deles, e um nextCursor. Uma renderização do Aplicar EDL feita com qualidade de Prévia traz preview: true, e a linha de texto dela diz (preview). Um arquivo cuja cópia armazenada sumiu não é listado nem contado.
get_asset
Retorna os detalhes de um resultado: a URL da saída, o prompt e o modelo. Retorna as suas próprias tarefas em qualquer status e as tarefas públicas e concluídas de outros usuários. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), retorna só as suas próprias tarefas, e a tarefa de outro usuário aparece como não encontrada. Uma tarefa pública de outro usuário não traz as palavras do provedor sobre uma falha (errorDetail é null) nem o ID desse usuário. Para uma tarefa com falha, acrescenta retryable, guidance e, quando houver, suggestedProvider; Quando uma tarefa falha explica esses campos.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. O ID da tarefa do resultado. |
Retorna: o envelope da tarefa, sem input.
display_asset
Mostra um resultado no chat: o usuário vê a imagem, o vídeo ou o áudio em vez de dados. As imagens também ganham os botões Animate, Edit e Recreate e uma visualização em tela cheia. Use get_asset quando o assistente só precisar dos detalhes.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. Uma tarefa sua em qualquer status, ou uma tarefa pública e concluída de outro usuário. |
Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), display_asset mostra só as suas próprias tarefas. A tarefa de outro usuário aparece como não encontrada.
Retorna: o cartão de mídia, com os detalhes do resultado como dados.
get_app_run
Retorna o progresso de uma execução de workflow ou de app publicado: o status, o estado de cada nó e todas as URLs de saída produzidas até o momento. Cada URL vem com o prompt, o modelo e o ID da tarefa. Use-a depois de run_workflow, render_final e run_app, que retornam um ID de execução (execution_id) em vez de um ID de tarefa. get_job não encontra um ID de execução. Chame-a a cada 5 a 10 segundos enquanto a execução estiver pending ou running.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
execution_id | string | Obrigatório. O ID da execução. |
Retorna: o status da execução, os estados dos nós e as saídas até o momento:
executionId,status,errorMessagee umsummarycom as contagenstotal,completed,failed,skippedeskippedForEmptyInput.nodeStates, uma entrada por nó, na ordem do workflow:id,label,nodeType,status,error,jobId,textemedia.texté a saída de texto do nó, cortada em 1.500 caracteres, comtextTruncated: truequando foi cortada.medialista cada URL de imagem, vídeo e áudio que o nó produziu, cada uma como{ kind, url }.skipReason: "empty_input"significa que nada chegou à entrada do nó nesta execução.outputs, cada URL de mídia da execução, com oprompt, omodele ocreatedAtda tarefa que a gerou.resumeHint, em uma execução que falhou e querun_workflowpode continuar (um workflow salvo no projeto mcp, não uma execução de app): a chamada derun_workflowque a continua de onde ela parou. Veja Continuar uma execução que falhou. Uma execução de app que falhou traz, em vez disso, o Tentar novamente do app: a chamada deretry_app_runque o cota. Só a execução atual da execução de app o traz, então, depois de um Tentar novamente ou de um novo começo, a execução anterior não recebe nenhum. A chamada indica aversionda própria execução quando o app mudou desde a execução.
Quando a execução termina, ela também traz outcome. O resultado é "nothing_new" quando pelo menos um nó foi pulado porque nada chegou à entrada dele e nada falhou, por exemplo um feed que não encontrou posts novos. Caso contrário, é "succeeded". Uma execução com falha ou cancelada tem um status, não um outcome.
list_favorites
Lista os IDs de tarefa dos seus resultados favoritos, dos mais recentes para os mais antigos.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
limit | integer | De 1 a 100. |
cursor | string | O cursor da página anterior. |
Retorna: os IDs de tarefa dos seus favoritos. Uma renderização sua do Aplicar EDL marcada como favorita também aparece, com preview: true em uma Prévia. A renderização de outra pessoa não aparece. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), só as suas próprias tarefas são retornadas.
favorite_asset
Adiciona um resultado aos seus favoritos ou o remove deles. O resultado pode ser uma das suas próprias tarefas ou uma tarefa pública de outro usuário. Em uma implantação que não permite trabalhos públicos (outputs.allowPublic: false), você só pode marcar as suas próprias tarefas. Remover um favorito sempre funciona. list_jobs com favorited: true lista as tarefas que você marcou como favoritas.
Permissão: assets:write. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. O resultado a marcar. |
favorited | boolean | Obrigatório. true adiciona o favorito, false o remove. |
Retorna: uma confirmação.
Perguntas frequentes
Como vejo a minha galeria do Nodaro no Claude?
Peça para ver a sua galeria. browse_gallery mostra as suas imagens e vídeos recentes numa grade clicável e também pode buscar nos seus prompts, por exemplo todas as imagens com um coelho.
Qual é a diferença entre browse_gallery e browse_uploads?
browse_gallery mostra os resultados que o Nodaro gerou para você. browse_uploads mostra os arquivos que você mesmo enviou, para que você escolha um deles como entrada de uma nova geração.
O assistente pode usar um resultado da galeria pública?
Sim. get_asset e display_asset retornam as suas próprias tarefas e as tarefas públicas e concluídas de qualquer outro usuário, então o assistente pode passar a URL de um resultado público para outra ferramenta. Uma implantação que não permite trabalhos públicos retorna só as suas próprias tarefas.
Como acompanho uma execução de workflow que um assistente iniciou?
Chame get_app_run com o ID de execução que run_workflow ou run_app retornou. A ferramenta mostra o status da execução, o estado de cada nó e todas as saídas produzidas até o momento.
Páginas relacionadas
Tarefas
Uploads
Apps e componentes
Entidades e mídias
Última atualização
Uploads
Envie suas imagens, áudios e vídeos ao Nodaro de qualquer cliente MCP: com um seletor no chat, um link no navegador ou uma URL pré-assinada via shell.
Modelos, créditos e predefinições
Liste os modelos do Nodaro com recursos e preços em créditos, leia saldo e gastos e encontre, salve e aplique predefinições de nó num assistente de IA.