Docs do NodaroGaleria e mídias
Num assistente de IA, navegue pela galeria e pelos uploads do Nodaro, mostre um resultado no chat, leia um job, 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 | Uma palavra a buscar nos prompts, com até 200 caracteres, por exemplo rabbit. |
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.
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 | Parte do nome de um arquivo, com até 200 caracteres. |
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.
get_asset
Retorna os detalhes de um resultado: a URL da saída, o prompt e o modelo. Retorna os seus próprios jobs em qualquer status e os jobs públicos e concluídos de outros usuários. Para um job com falha, acrescenta retryable, guidance e, quando houver, suggestedProvider; Quando um job falha explica esses campos.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. O ID do job do resultado. |
Retorna: o envelope do job, 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. Um job seu em qualquer status, ou um job público e concluído de outro usuário. |
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 do job. Use-a depois de run_workflow e run_app, que retornam um ID de execução em vez de um ID de job.
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.
list_favorites
Lista os IDs de job 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 job dos seus favoritos.
favorite_asset
Adiciona um resultado aos seus favoritos ou o remove deles.
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
Páginas relacionadas
Jobs
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 seu saldo e suas compras e aplique predefinições de nó a partir de um assistente de IA.