# コンテンツ権利 > Nodaro が動画リンクをインポートする前に、本人がコンテンツ権利の宣言を確認します。宣言を読み取り、リンクごとに確認するか、キーとエージェントを一度だけ承認します。 Source: https://nodaro.ai/ja/docs/developers/api/content-rights **コンテンツ権利**とは、Nodaro が誰かの動画、画像、録音へのリンクをインポートする前に、本人が確認する宣言です。本人は、コンテンツの権利を持っているか権利者の許可を得ていること、そしてその使い方に責任を負うことを確認します。Nodaro は、すべての確認を記録します。誰が、どのリンクについて、どの文面を、いつ、どこから確認したか、そしてその確認のもとで行われたダウンロードです。 ## 確認が必要なインポート リンクを取得するすべてのルートが、同じチェックを行います。 - 動画のインポート、`POST /v1/download-video`。 - オーディオのインポート、`POST /v1/youtube-audio` と `POST /v1/extract-youtube-audio`。 - 画像と録音のインポート、`POST /v1/media/import-url` と `POST /v1/media/import-recording`。 - 動画のページへのリンクが渡されたときの `POST /v1/trim-audio`。 - 実行自身による[**動画 URL**](https://nodaro.ai/docs/nodes/automate/video-url)ノードの取得。動画とその音声の両方です。 - 動画のページへのリンクが渡された文字起こしと Suno カバー。`POST /v1/transcribe`（その `audioUrl`）、`POST /v1/suno/cover` と `POST /v1/suno/upload-extend`（その `uploadUrl`）、および MCP のオーディオツールです。 - リンクが渡された吹き替え。`sourceUrl` を指定した `POST /v1/dubbing` と、リンクが渡された実行の吹き替えノードです。 これらのルートは、確認を `confirmationId` として受け取ります。自分のデバイスからアップロードしたファイルはリンクのインポートではないため、確認は不要です。 **文字起こしと Suno。** 動画のページへのリンクは先に音声が取得されるため、ルートは同じ方法で確認を受け取ります。確認はジョブが作成される前にチェックされます。拒否は、理由を示すコードとともに `403` になり、何も課金されません。ジョブは、音声を取得する直前に確認を使います。ファイルへの直接リンクには確認は不要です。リンクのホストがプラットフォーム自身のホストのいずれかである場合、そのリンクは動画のページです。プラットフォームの名前を含むだけのホストは、通常のファイルとして扱われます。 **吹き替え。** `POST /v1/dubbing` は `sourceUrl` を吹き替えサービスに渡し、サービスがそれを自分で取得します。これは、動画のページでもファイルへの直接リンクでも、リンクのインポートです。デプロイ環境自身のストレージのファイルではないすべての `sourceUrl` は、`confirmationId` を受け取ります。確認は、長さのチェックも含め、リンクに何かが触れる前に読み取られます。拒否は、ジョブが作成される前の `403` になります。`audioUrl` や `videoUrl` は、ほかのノードと同じメディアの入力なので、確認は不要です。 **そのまま拒否されるリンク。** これらのルートは、バックスラッシュ、またはタブや改行などの制御文字を含むリンクを、何かが読み取る前に `400 validation_error` で拒否します。実際のリンクに、これらが含まれることはありません。 確認のないインポートを拒否するかどうかは、デプロイ環境の設定です。設定がオフの間は、インポートは受け付けられます。オンになると、インポートは `403 rights_confirmation_required` を返します。設定が変わってもクライアントが動き続けるように、毎回確認を送ってください。 ## ルート | メソッド | パス | 動作 | | --- | --- | --- | | `GET` | `/v1/content-rights/declaration` | 現在の宣言を返します：`{ data: { version, text } }`。公開されているため、クライアントは誰もサインインしていないうちに表示できます。 | | `POST` | `/v1/content-rights/confirm` | サインインしているアカウントが、1 件のリンクについて宣言を確認したことを記録します。ボディ：`{ url, declarationVersion }`。`201 { data: { id, declarationVersion, expiresAt } }` を返します。インポートが受け取る `http(s)` のリンクであれば、どれでも確認できます。動画のページ、ファイル、画像、または吹き替えサービスが読み取るページです。バックスラッシュや制御文字を含むリンクは `400` になります。 | | `GET` | `/v1/content-rights/authorization` | アカウントの継続的な承認を返します：`{ data: { id, declarationVersion, createdAt } }`。承認がない場合は `{ data: null }` です。 | | `POST` | `/v1/content-rights/authorization` | 現在の宣言について、継続的な承認を記録します。ボディ：`{ declarationVersion }`。`201 { data: { id, declarationVersion, createdAt } }` を返します。本人がサインインしている自分のセッションからのみ呼び出せます。 | | `DELETE` | `/v1/content-rights/authorization` | 継続的な承認を取り消します。記録は残ります。`{ data: { revoked } }` を返します。本人がサインインしている自分のセッションからのみ呼び出せます。 | `POST /v1/content-rights/confirm` と `POST /v1/content-rights/authorization` は、クライアントが宣言を読み取った後に宣言が変わった場合、`409 rights_confirmation_stale` を返します。宣言をもう一度読み取り、本人にもう一度確認を求めてください。 ## リンクを確認してからインポートする ### 宣言を読み取る `GET /v1/content-rights/declaration` を呼び出します。その `text` をそのまま、最初はチェックの入っていないチェックボックスとともに表示します。 ### リンクを確認する 本人がチェックを入れたら、リンクと宣言の `version` を指定して `POST /v1/content-rights/confirm` を呼び出します。 ### リンクをインポートする 返された `id` を、インポートの `confirmationId` として送ります。たとえば `POST /v1/download-video` に送ります。 **curl** ```bash VERSION=$(curl -s https://app.nodaro.ai/v1/content-rights/declaration | jq -r .data.version) CONFIRMATION=$(curl -s -X POST https://app.nodaro.ai/v1/content-rights/confirm \ -H "Authorization: Bearer $NODARO_API_KEY" -H 'Content-Type: application/json' \ -d "{ \"url\": \"https://example.com/watch/VIDEO_ID\", \"declarationVersion\": $VERSION }" | jq -r .data.id) curl -s -X POST https://app.nodaro.ai/v1/download-video \ -H "Authorization: Bearer $NODARO_API_KEY" -H 'Content-Type: application/json' \ -d "{ \"url\": \"https://example.com/watch/VIDEO_ID\", \"confirmationId\": \"$CONFIRMATION\" }" ``` **TypeScript SDK** ```ts const { version, text } = await client.contentRights.declaration() // Show `text` with a checkbox. Once it is ticked: const { id } = await client.contentRights.confirm({ url, declarationVersion: version }) const { downloadId } = await client.media.downloadVideo({ url, maxHeight: 1080, confirmationId: id }) ``` 1 件の確認で開けるのは、そのリンクのダウンロード 1 回です。ダウンロードは、同じアカウントが、現在の宣言のもとで、1 時間以内に行う必要があります。リンクは正規化した後で比較されます。クエリパラメーターだけが違う同じ動画は一致し、別の動画が一致することはありません。その後、ダウンロードは保存されたファイルに確認を付けて持ち運びます。 確認は、ほかの理由でインポートが拒否されるより前にチェックされ、ダウンロードが始まる直前にだけ使用済みになります。`429 too_many_downloads` や拒否されたアドレスで、確認が使われてしまうことはありません。拒否されたインポートが取得を始めることはありません。 ## API キー、接続済みアプリ、AI エージェントによるインポート 個人の API キー、接続済みアプリ、または MCP 経由の AI エージェントが行うインポートには、リンクごとにチェックを入れる人がいません。本人は、サインインしている自分のセッションで、それらのインポートを一度だけ承認します。 - アプリでは、**設定**の**API キー、接続済みアプリ、AI エージェントによる取り込み**で、チェックを入れて**承認する**をクリックします。**取り消す**で承認が終わります。 - コードからは、本人の自分のセッションから `POST /v1/content-rights/authorization` を呼び出します。キー、アプリ、エージェントがこのルートを呼び出すと、`403 forbidden` で拒否されます。 継続的な承認があると、アカウントのキー、アプリ、エージェントによるインポートのすべてが、その承認から作られた確認として、ダウンロードごとに 1 件ずつ記録されます。インポートは `confirmationId` なしで通ります。送った `confirmationId` がある場合は、それが先に使われます。キー、アプリ、エージェントが開始した実行は、その実行が行うすべてのインポートに、同じ承認を適用します。 承認には、それが与えられた宣言のバージョンが記録されます。新しい宣言には、新しいチェックが必要なのと同じく、新しい承認が必要です。それまでは、アカウントは未承認として扱われます。 接続済みアプリがインポートと確認を行えるのは、アカウントのために書き込めるスコープ、つまり `:write` または `:execute` のいずれかのスコープがある場合だけです。読み取りのスコープしかないアプリは、コンテンツ権利のチェックより前に `403 insufficient_scope` で拒否されます。 デプロイ環境が確認を必須としている間、確認も継続的な承認もないキー、アプリ、エージェントによるインポートは、`403 rights_authorization_required` で拒否されます。解決するには、本人が設定で承認します。スケジュール実行や Webhook による実行のように、入り口がまったくない実行は、どの承認の対象にもならず、チェックを入れなかった人と同じように拒否されます。 ## 実行の中の動画 URL ノード 実行自身による[**動画 URL**](https://nodaro.ai/docs/nodes/automate/video-url)ノードの取得は、確認を実行のリクエストから受け取ります。`POST /v1/workflows/:id/run` または `POST /v1/app/:slug/run` で、`inputOverrides` のノードに `rightsConfirmationId` を設定します。 ```json { "inputOverrides": { "