# Galeria 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.

Source: https://nodaro.ai/pt-BR/docs/mcp/tools/gallery-and-assets

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`](https://nodaro.ai/docs/mcp/tools/jobs#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](https://nodaro.ai/docs/mcp/tools/jobs#when-a-job-fails) 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](https://nodaro.ai/docs/mcp/tools/jobs#the-job-envelope), 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`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#run_workflow) e [`run_app`](https://nodaro.ai/docs/mcp/tools/apps-and-components#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.

## Frequently asked questions

### 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 os seus próprios jobs e os jobs públicos e concluídos de qualquer outro usuário, então o assistente pode passar a URL de um resultado público para outra ferramenta.

### 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.
