アップロード

アップロードツールは、あなた自身のファイルを Nodaro に取り込みます。これにより、アシスタントは写真、音声の録音、クリップを次の生成に使えます。アップロードの方法は 3 つあります。チャット内のピッカー、ブラウザーで開くリンク、シェルコマンドを実行できるクライアント向けの署名付き URL です。どのアップロードツールにも assets:write 権限が必要です。アップロードにクレジットはかかりません。

どの方法を使うか

以前のジョブの結果など、ファイルにすでに公開 URL がある場合は、アップロードせずに、その URL を直接渡してください。

upload_image_widget

チャットの中に、画像用のファイルピッカーを開きます。スマートフォンでは、ピッカーからカメラまたはフォトライブラリが開きます。ウィジェットがファイルをアップロードし、その公開 URL をチャットに伝えるので、ピッカーを 1 回タップするだけで済みます。upload_audio_widget と upload_video_widget は、オーディオと動画に対して同じように動作します。

権限：assets:write。クレジット：無料。

戻り値：{ upload_url, public_url } のペアのリストである uploads と、最初のファイルの upload_url と public_url です。ピッカーを表示できないクライアントでも、これらを通常のリンクとして表示できます。

request_image_upload

Nodaro の短いリンクを返します。そのリンクを任意のブラウザーで開き、画像をドロップします。ファイルはあなた自身のブラウザーを通って送られるため、どのクライアントでも、どんなファイルサイズでも使えます。request_audio_upload と request_video_upload は、オーディオと動画に対して同じことを行います。

権限：assets:write。クレジット：無料。

このツールにはパラメーターがありません。

戻り値：開くページである upload_page_url と、ファイルのアドレスになる public_url です。公開 URL は事前にわかっているので、アップロードが終わったことをあなたが伝えれば、アシスタントは次の呼び出しでその URL を使えます。

prepare_image_upload

署名付きのアップロード URL を返します。アシスタントは curl で、この URL にファイルを送信します。ファイルは会話を経由しないため、サイズは問題になりません。prepare_audio_upload と prepare_video_upload は、オーディオと動画に対して同じことを行います。

権限：assets:write。クレジット：無料。

戻り値：1 時間有効な upload_url と、public_url です。アシスタントは、次のコマンドでファイルをアップロードします。

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

その後、public_url を次のツールに渡します。たとえば、image_url として渡します。

アップロードした後

• 公開 URL を渡す：modify_image、animate_image、lip_sync、add_captions など、メディアを受け取るツールであれば、どれにでも公開 URL を渡せます。
• 以前のアップロードを探す：browse_uploads を使います。このツールは、Nodaro が生成した結果とは別に、あなたがアップロードしたファイルを一覧表示します。
• ナレーション付き動画にロゴを表示する：動画ディレクターで使うブランドロゴは、Nodaro にアップロードした画像である必要があります。そのため、先にこれらのツールのいずれかでアップロードしてください。