Uploads

As ferramentas de upload trazem os seus próprios arquivos para o Nodaro, para que um assistente possa usar uma foto, uma gravação de voz ou um clipe na próxima geração. Há três formas de enviar arquivos: um seletor no chat, um link que você abre no navegador e uma URL pré-assinada para clientes que conseguem executar comandos de shell. Todas as ferramentas de upload precisam da permissão assets:write, e o upload não custa créditos.

Qual método usar

Quando um arquivo já tem uma URL pública, por exemplo o resultado de um job anterior, passe essa URL diretamente e pule o upload.

upload_image_widget

Abre um seletor de arquivos de imagem dentro do chat. No celular, o seletor abre a câmera ou a galeria de fotos. O widget envia os arquivos e informa as URLs públicas deles de volta no chat, então você só toca no seletor uma vez. upload_audio_widget e upload_video_widget funcionam do mesmo jeito para áudio e vídeo.

Permissão: assets:write. Créditos: grátis.

Retorna: uploads, uma lista de pares { upload_url, public_url }, além de upload_url e public_url do primeiro arquivo. Um cliente que não mostra o seletor ainda pode mostrá-los como links simples.

request_image_upload

Retorna um link curto do Nodaro que você abre em qualquer navegador para soltar uma imagem. Funciona em todos os clientes e com qualquer tamanho de arquivo, porque o arquivo passa pelo seu próprio navegador. request_audio_upload e request_video_upload fazem o mesmo para áudio e vídeo.

Permissão: assets:write. Créditos: grátis.

Esta ferramenta não tem parâmetros.

Retorna: upload_page_url, a página a abrir, e public_url, o endereço que o arquivo terá. A URL pública é conhecida de antemão, então o assistente pode usá-la na próxima chamada assim que você confirmar que o upload terminou.

prepare_image_upload

Retorna uma URL de upload pré-assinada, para a qual o assistente envia o arquivo com curl. O arquivo nunca passa pela conversa, então o tamanho dele não importa. prepare_audio_upload e prepare_video_upload fazem o mesmo para áudio e vídeo.

Permissão: assets:write. Créditos: grátis.

Retorna: upload_url, válida por 1 hora, e public_url. O assistente envia o arquivo com:

curl -X PUT --data-binary @path/to/file -H 'Content-Type: image/png' '<upload_url>'

Depois, ele passa public_url para a próxima ferramenta, por exemplo como image_url.

Depois do upload

• Passe a URL pública para qualquer ferramenta que recebe mídia, como modify_image, animate_image, lip_sync ou add_captions.
• Encontre uploads anteriores com browse_uploads, que lista os arquivos que você enviou, separados dos resultados que o Nodaro gerou.
• Mostre um logo num vídeo narrado. O logo da marca do Diretor de vídeo precisa ser uma imagem enviada ao Nodaro, então envie-o primeiro com uma destas ferramentas.