# Video Remake

> Video Remake は、AI モーションコントロールやキャラクタースワップと呼ばれる機能です。4〜30 秒の動画の人物、ペット、商品、場所を、動きはそのままに自分の画像に置き換えます。

Source: https://nodaro.ai/ja/docs/developers/api/video-remake

**Video Remake API** は、短い動画の人物、ペット、商品、場所を、あなた自身のリファレンス画像に置き換えます。動画の動き、構図、タイミング、音声はそのまま残ります。クリップの音声は保持され、結果の長さはクリップと同じです。実行の見積もりを無料で出し、実行を開始して、ほかのジョブと同じようにそのジョブを追跡します。

Video Remake は、よく AI モーションコントロールやキャラクタースワップと呼ばれるものです。1 枚の静止画のキャラクターに動画の動きをさせる場合は、[モーション転送](https://nodaro.ai/docs/nodes/video/motion-transfer)ノードを使います。

Video Remake は Nodaro Cloud でのみ動作します。セルフホスティング環境では、Video Remake のすべてのルートが `404` を返します。これらのルートは Bearer トークンを受け取ります。[認証](https://nodaro.ai/docs/developers/api/authentication)を参照してください。

## エンドポイント
| メソッド | パス | 内容 | 料金 |
| --- | --- | --- | --- |
| `POST` | `/v1/video-remake/estimate` | 実行の見積もりを出します。何も作成も確保もされません。 | 無料 |
| `POST` | `/v1/video-remake` | 実行を開始します。`202 { jobId }` を返します。`GET /v1/jobs/:id` でジョブを追跡します。 | 見積もった実行の料金 |
| `POST` | `/v1/video-remake/:jobId/full-quality/estimate` | ドラフトの実行のフル品質版を見積もります。何も作成も確保もされません。 | 無料 |
| `POST` | `/v1/video-remake/:jobId/full-quality` | ドラフトを、新しいジョブとして 1080p で仕上げます。[フル品質](#full-quality)を参照してください。 | 見積もった実行の料金 |
| `GET` | `/v1/video-remake/style-choice` | エンジンごとに、実行の `style` をあなたが選ぶのか、Nodaro がモーションに固定したのか、そのエンジンがスタイルのみの実行を受け付けるか、精密の実行がアートスタイルを受け付けるかを返します。公開されており、サインインは不要です。[スタイル](#style)を参照してください。 | 無料 |
| `GET` | `/v1/video-remake/advanced` | Video Remake のページが詳細設定を表示するかどうかを返します。公開されており、サインインは不要です。[スタイル](#style)を参照してください。 | 無料 |

## リクエストボディ
どちらのルートも同じボディを受け取ります。

| フィールド | 内容 |
| --- | --- |
| `videoUrl` | 必須。元のクリップで、4〜30 秒です。 |
| `roles` | 必須。人物のロールを最大 6 個、場所のロールを 1 個、ペットのロールを 3 個、商品のロールを 3 個です。下記を参照してください。 |
| `references` | 任意。最大 5 個の固定のリファレンスです。どのロールにも置き換えられない、動画に映すものです。[固定のリファレンス](#fixed-references)を参照してください。 |
| `prePrompt` | 任意。プロンプトの先頭、ロールの指示より前に置く、あなた自身の言葉です。`postPrompt` と同じ上限があり、同じように `{role:N}` で指定できます。 |
| `postPrompt` | 任意。モデルに渡すあなた自身の言葉で、最大 4,000 文字です。ロールは `{role:N}` で指定します。N は `roles` を 1 から数えた番号で、空のロールも数えます。 |
| `preview` | 任意。`true` にすると、クリップの `previewStart` から 4 秒をレンダリングします。 |
| `previewStart` | 任意。プレビューの開始位置で、単位は秒です。デフォルトは 0 です。 |
| `engine` | 任意。エンジンです。`"nodaro-prism"`（Nodaro Prism、デフォルト）または `"nodaro-pulse"`（Nodaro Pulse）です。[エンジン](#engines)を参照してください。 |
| `style` | 任意。実行がクリップにどう従うかです。`"precise"`（デフォルト）または `"motion"` です。[スタイル](#style)を参照してください。 |
| `direction` | 任意。Nodaro Prism のみです。アートスタイルで、`{ style: "<id>" }` の形です。ID は[スタイル](https://nodaro.ai/docs/nodes/creative-controls/style)ピッカーのカタログのいずれかです。[アートスタイル](#art-styles)を参照してください。 |
| `motionLength` | 任意。Nodaro Pulse のみです。クリップを秒単位に切りそろえる位置です。`"cut-end"`（デフォルト）または `"cut-start"` です。 |
| `resolution` | 任意。`"480p"`（デフォルト）、`"720p"` または `"1080p"` です。Nodaro Pulse では、`"720p"`（Nodaro Pulse のデフォルト）または `"1080p"` です。 |
| `draft` | 任意。デフォルトはオフなので、480p の実行は通常の実行です。`true` にすると 480p のドラフトを作り、その同じテイクを後で[フル品質](#full-quality)で 1080p に仕上げられます。480p より上で `true` にすると拒否されます。Nodaro Pulse にはドラフトがありません。 |
| `prepareReferences` | 任意。デフォルトは `true` です。[リファレンスの準備](#reference-preparation)を参照してください。 |
| `quality` | 非推奨。`"draft"` は引き続き使え、480p のドラフトを意味します。代わりに `resolution` と `draft` を使ってください。 |
| `sessionId`、`origin` | 任意。結果を保存するセッションと、あなたのアプリの origin ラベルです。 |

ロールは、動画の中の誰か、何か、または舞台を指し、1 つの対象か 1 か所の場所の画像を 0〜3 枚受け取ります。1 回のリクエストで受け取れる画像は合計 30 枚までです。

- **人物：** `{ kind: "person", name?, images, body?, outfit?, hair? }`。`name` は動画の中の誰かを示します。たとえば `"the woman dancing"`（踊っている女性）です。
- **ペット：** `{ kind: "pet", name?, images, body?, coat? }`。
- **商品：** `{ kind: "product", name?, images, shape?, finish? }`。
- **場所：** `{ kind: "location", name?, images }`。デフォルトの名前は `"the setting"`（舞台）です。

人物、ペット、商品のロールは、`name` を省略することも、空で送ることもできます。その場合、ロールは最初の画像で名前が付けられ、動画の中でその画像に最も合う対象に結び付けられます。このようなロールには、少なくとも 1 枚の画像が必要です。`name` は最大 200 文字です。トレンドの実行のロールには、常に名前が付いています。

各特徴（`body`、`outfit`、`hair`、`coat`、`shape`、`finish`）は、デフォルトの `"new"` ならあなたの画像から取り、`"original"` なら動画のまま残します。

画像のないロール（空または `null`）は、その対象や場所を動画のまま残します。画像のあるロールが少なくとも 1 個、リファレンス、`prePrompt` か `postPrompt`、またはアートスタイルが必要です。アートスタイルが数えられるのは、スタイルのみの実行の場合だけです（[アートスタイル](#art-styles)を参照してください）。

どのロールも、プレビューにだけ適用される 2 つの設定を受け取れます。通常の実行では、どちらも無視されます。

- `previewName` は、プレビューで `name` の代わりに使われる名前です。
- `inPreview: false` にすると、そのロールはプレビューから外れます。その画像は送信も準備も課金もされません。`{role:N}` による指定は番号をそのまま保ち、ロールの `previewName`、なければ `name` として読まれます。

```json
{
"videoUrl": "https://example.com/clip.mp4",
"roles": [
{ "kind": "person", "name": "the woman dancing", "images": ["https://example.com/me.jpg"], "outfit": "original" }
],
"preview": true
}
```

## エンジン
`engine` は、結果を作るエンジンを選びます。省略すると Nodaro Prism のままです。

| エンジン | 解像度 | ドラフト | フル品質 |
| --- | --- | --- | --- |
| `"nodaro-prism"`、Nodaro Prism（デフォルト） | 480p（デフォルト）、720p、1080p | 480p で `draft: true` のとき | ドラフト自体のテイクを 1080p で再レンダリング |
| `"nodaro-pulse"`、Nodaro Pulse | 720p（デフォルト）、1080p | なし | なし：1080p でもう一度実行してください |

- **Nodaro Pulse** は、クリップとあなたの画像をもとに新しいテイクを作ります。
- Nodaro Pulse で `draft: true` にすると `draft_unsupported` で、`"480p"` にすると `resolution_unsupported` で拒否されます。
- Nodaro Pulse は秒単位でレンダリングするので、クリップは秒単位に切りそろえられます。その位置は `motionLength` で指定します。`"cut-end"` は末尾の 1 秒未満の端数を落とし、`"cut-start"` は先頭の端数を落とします。Nodaro Prism は `motionLength` を無視します。
- プレビューは、どちらのエンジンでも `previewStart` から 4 秒です。
- Nodaro Pulse が 1 回の実行で受け取れる画像は、すべてのロールと固定のリファレンスを合わせて 10 枚までです。それより多いと `too_many_images` で拒否されます。Nodaro Prism は 30 枚まで受け取れます。
- ジョブは、エンジンを `input_data.engine` に記録します。完了したジョブの出力では、`engine` にエンジンが示されます。

## スタイル
`style` は、実行がクリップにどう従うかを指定します。省略すると精密のままです。

- `"precise"`（デフォルト）は、クリップに正確に従います。
- `"motion"` は、クリップの動きに従い、人物、ペット、商品の見た目をあなたの画像から取ります。精密よりも自由にクリップに従います。

どちらのスタイルも、クリップの音声と長さを保ちます。モーションは、精密と料金が異なることがあります。正確な料金を確認するには、同じ `style` を `POST /v1/video-remake/estimate` に送ってください。

ジョブは、送られた `style` を `input_data.style` に記録します。`style` を省略した場合、このフィールドはなく、精密を意味します。トレンドの実行は `style` を無視します。トレンドがそれを決めるからです。

Nodaro は、あるエンジンのスタイルを全員に対してモーションに固定できます。その場合、そのエンジンでのすべての実行と見積もりは、`style` の値にかかわらず、モーションの実行になります。`GET /v1/video-remake/style-choice` は、エンジンごとにどちらかを返し、サインインは不要です。

```json
{ "engines": { "nodaro-prism": "user", "nodaro-pulse": "precise" } }
```

各値は `"user"`（上記のとおり、あなたが選びます）、`"precise"`、または `"flex"`（モーション、つまり `style: "motion"` で、上記のとおり固定されます）です。`"precise"` は、どのリクエストも変えません。Nodaro 自身のアプリは、そのエンジンで精密を実行し、スタイルの選択を隠します。そのエンジンでのすべての実行と見積もりは、`"user"` と返ったエンジンと同じように、送られた `style` を使います。アプリでスタイルの選択を表示するのは、`"user"` と返ったエンジンだけにしてください。

同じ答えには、さらに 3 つのマップが含まれます。どれも `{ "nodaro-prism": boolean, "nodaro-pulse": boolean }` です。

- `styleOnly` は、そのエンジンがスタイルのみの実行を受け付けるかを示します。[アートスタイル](#art-styles)を参照してください。
- `preciseArtStyle` は、そのエンジンで精密の実行がアートスタイルを受け付けるかを示します。
- `preciseArtStyleAlone` は、そのエンジンで、ロールもリファレンスもプロンプトもなく、アートスタイルだけを精密の実行の変更にできるかを示します。エンジンがそのような実行を受け付けるまでは `false` を返します。Nodaro はそのようなリクエストをモーションの実行として実行することがありますが、このマップはそれを示しません。[精密の実行でのアートスタイル](#art-styles)を参照してください。

3 つともエンジンだけに従うので、`engines` と合わせて読んでください。Nodaro Pulse は、3 つとも常に `false` です。これらより前のサーバーは、どれも返しません。その場合は、すべてのエンジンで `false` として読んでください。`"flex"` と返ったエンジンでは、すべての実行がモーションの実行です。

この答えは最大 1 分前のものの場合があります。トレンドには影響しません。

**Video Remake のページの詳細設定。** Video Remake のページは、ボディの 2 つのフィールド `prepareReferences` と `prePrompt` を、詳細設定の中でだけ提供します。これらの設定は、Nodaro が有効にしない限り非表示のままです。この設定はページ全体とすべてのエンジンに共通で 1 つです。`GET /v1/video-remake/advanced` はサインイン不要で、`{ show: boolean }` を返します。そのため、この API で作ったアプリでも同じ設定を表示または非表示にできます。この答えはページだけを説明するものです。すべての実行と見積もりは、答えにかかわらず `prepareReferences` と `prePrompt` を受け付けます。この答えは最大 1 分前のものの場合があります。SDK にはまだこのためのメソッドがないので、`client.request()` で読み取ってください。

Nodaro がモーションの実行をエンジン向けに準備する方法によってクリップが制限されている間は、27.9 秒を超えるクリップのモーションのフル実行は `clip_too_long_for_style` で拒否されます。Nodaro Pulse では、クリップを秒単位に切りそろえた後の長さで数えます。プレビューには制限がありません。

## アートスタイル
`direction: { style: "<id>" }` は、`pop-art` などのアートスタイルで動画を描きます。ID は[スタイル](https://nodaro.ai/docs/nodes/creative-controls/style)ピッカーのカタログのいずれかです。アートスタイルを受け付けるのは Nodaro Prism だけです。Nodaro Pulse は `400 art_style_needs_prism` で拒否します。

**クリップ全体のスタイル変更（スタイルのみ）。** モーションの実行（`style: "motion"`）は、置き換えるものがなくても、つまり画像のあるロールも固定のリファレンスもなくても、アートスタイルを受け付けます。アートスタイルがその実行の変更なので、実行は受け付けられます。`prePrompt` や `postPrompt` は、この場合も追加されます。実行はクリップ全体のスタイルを変え、人物、場所、動き、音声は保ちます。

- 実際に行う処理の分だけ課金されます。基本料金と動画で、`privacy` の部分はありません。`referenceAudio` の部分は Nodaro のエンジンの設定がその処理を行う場合だけ、`prompt` の部分は設定が言語モデルにプロンプトを書かせる場合だけ表示されます。料金を確認するには、同じボディを `POST /v1/video-remake/estimate` に送ってください。
- デフォルトでは、白黒のアートスタイルはモノクロになります。Nodaro は代わりに、これらをほかのアートスタイルの実行と同じ方法で実行することもあります。その場合は、それらと同じ料金で、モノクロにはなりません。
- プレビューは、そのフル実行と同じ処理をたどります。画像のあるロールをすべて外したプレビュー（`inPreview: false`）も、そのフル実行の処理をたどり、アートスタイルがプレビューの変更として数えられます。
- この機能は、`GET /v1/video-remake/style-choice` がそのエンジンで `styleOnly: true` と返す場合だけ提供してください。Nodaro Prism が `false` と返る間は、ほかに変えるものがないアートスタイルは `400 validation_error` で拒否されます。`prePrompt` か `postPrompt` がある場合は受け付けられますが、ほかのアートスタイルの実行と同じように実行されます。
- 実行は、この場合もモーションである必要があります。`"precise"` と返ったエンジンは、どのリクエストも変えません。そのため、そこでのモーションの実行は、`"user"` と返ったエンジンと同じようにクリップのスタイルを変えます。

**精密の実行でのアートスタイル。** `GET /v1/video-remake/style-choice` がそのエンジンで `preciseArtStyle: true` と返す場合は、精密の実行もアートスタイルを受け付けます。Nodaro はこれを、モーションの実行と同じ方法で作ることがあります。モーションの実行では、アートスタイルが画面全体にずっと安定して保たれます。その場合は次のとおりです。

- ジョブは、送られたスタイルをそのまま記録します。`input_data.style` はないか、`"precise"` です。ジョブを読み返しても、同じボディをもう一度送っても、同じ実行を求めることになります。
- 同じボディで送った見積もり、料金、フル品質、スタイルのみの動作は、モーションの実行のものになります。
- ほかに変えるものがなければ、スタイルのみの実行として受け付けられます。
- どちらが適用されるかは、`style-choice` には表示されません。実行の料金は見積もりで確認してください。
- スタイルが保たれるようになる前にこの方法で作られたジョブは、`input_data.style: "motion"` を記録しています。

それ以外の場合、実行は精密として作られます。クリップは精密と同じように編集され、人物も精密と同じように置き換えられ、動画全体がアートスタイルで描かれます。この場合は次のとおりです。

- ここでは、アートスタイルだけでは変更として数えられません。画像のあるロールも固定のリファレンスも `prePrompt` も `postPrompt` もない精密の実行は、この場合も `400 validation_error` で拒否されます。クリップ全体のスタイルだけを変えるには、モーションの実行（上記のスタイルのみ）を使ってください。
- 料金が変わるのは、Nodaro のこれらの実行の設定が、先にロールの画像をアートスタイルで描き直す場合だけです。同じボディで送った見積もりに、その料金が表示されます。
- ジョブは、アートスタイルを `input_data.direction` に記録します。
- `preciseArtStyle` が `false` の場合、またはそれより前のサーバーがこれを返さない場合、アートスタイルのある精密の実行は `400 art_style_needs_flex` で拒否されます。

カタログにない ID は `400 unknown_art_style` で、保存したムードボードは `400 art_style_not_supported` で拒否されます。`400 art_style_needs_flex` は、トレンドの実行でのアートスタイル、および Nodaro の設定によってプロンプトが精密になるモーションの実行でのアートスタイルにも返されます。この設定は固定されたスタイルではなく、`style-choice` には表示されません。

## 固定のリファレンス
`references` には、どのロールにも置き換えられない、動画に映すものを最大 5 個入れます。それぞれ `{ images, line }` です。

- `images` には、1 つのものを写した 1〜3 枚の画像を入れます。
- `line` は、それが何かを 1〜500 文字で示します。たとえば `"the glass she drinks from"`（彼女が飲んでいるグラス）です。
- 行の中の `{image}` は、そのリファレンスの最初の画像を表します。たとえば `"Use {image} for the sky"`（空には `{image}` を使う）です。`{image}` のない行には、末尾に `{image}` が追加されます。

リファレンスはそのまま送られ、準備されることはありません。リファレンスの画像も、30 枚の上限に含まれます。リファレンスだけでも実行できます。画像のあるロールは必要ありません。行は、もの自体を説明するものなので、`{role:N}` でロールを指定することはできません。

## リファレンスの準備
`prepareReferences` が `false` でない限り、人物、ペット、商品の各ロールの画像は、まず画像モデルによって 1 枚のきれいなリファレンス画像にまとめられます。動画はその画像から作られます。

- 準備には追加のクレジットがかかり、見積もりでは `breakdown.references` として示されます。このクレジットは準備が実行された時点で課金され、その後に動画が失敗しても課金されます。
- 所要時間が約 1 分増えます。
- あるロールの画像を作れなかった場合、そのロールにはあなた自身の画像が使われます。
- 場所は準備されません。

画像をそのまま使うには、`prepareReferences: false` を送ります。

## クリップの準備
ソースクリップを動画モデル向けにどう準備するかは、Nodaro がエンジンごとに設定します。たとえば、顔を先に隠すかどうかや、モデルが拒否したクリップを 1 回再試行するかどうかです。実行でこれを変えることはできません。古いクライアントが送る `faceMasking` フィールドは受け付けられ、無視されます。

完了したジョブの出力には、`privacy: { applied, reason }` が含まれます。`applied` は、準備したクリップから動画が作られたかどうかを示し、`reason` はその理由を示します。

## 見積もり
`POST /v1/video-remake/estimate` は `{ engine, totalCredits, expectedCredits, breakdown, privacyCredits?, settlesLower }` を返します。見積もりには 2 つの合計があります。

- `totalCredits` は、実行の開始時に確保される額です。
- `expectedCredits` は、実行に請求される見込みの額です。`totalCredits` を超えることはありません。実行には、実際にかかった額が請求されます。
- Nodaro Prism では、動画の長さはモデルが決めるので、動画は最も長い出力の分を確保します。請求される見込みは、入力クリップの長さと、それと同じ長さの出力の分です。`settlesLower: true` がそれを示します。最終的な請求は `totalCredits` より低く、`expectedCredits` 程度になる見込みです。
- Nodaro Pulse では、2 つの合計は等しく、`settlesLower` は `false` です。Nodaro Pulse は求められた長さをそのままレンダリングします。
- `engine` は、見積もりの対象のエンジンです。

`breakdown` は見積もりの各部分を示します。表示のためだけのものです。

| 部分 | 内容 |
| --- | --- |
| `base` | 実行そのものです。 |
| `references` | リファレンスの準備です。準備がオフの場合や準備するものがない場合は 0 です。 |
| `motion` | 動画が確保する額です。Nodaro Pulse では、動画にかかる額です。 |
| `motionExpected` | 動画に請求される見込みの額で、`motion` を超えることはありません。Nodaro Prism のみです。 |
| `privacy` | エンジンの設定がクリップを準備する場合の、その準備の料金です。毎回実行される場合は両方の合計に含まれ、下記の再試行の場合はどちらにも含まれません。 |
| `prompt` | エンジンの設定がプロンプトを求める場合に、言語モデルがその実行のために書くプロンプトの料金です。 |
| `referenceAudio` | エンジンの設定がその処理を行う場合に、動画モデル向けにクリップの音声を準備する料金です。 |

`motion` と `motionExpected` はどちらか一方なので、内訳の合計ではなく、2 つの合計を読んでください。

エンジンの設定が、拒否されたクリップを再試行する場合、`privacyCredits` は、その再試行が実行されたときにだけかかる追加料金です。どちらの合計にも含まれません。実行を開始するには、確保分と `privacyCredits` の両方に足りるクレジットが必要です。

## 繰り返し
実行を再試行するときは、同じ `Idempotency-Key` ヘッダー（8〜200 文字）を送ります。約 10 秒以内の繰り返しは、`X-Dedup-Hit: 1` ヘッダー付きで `200 { jobId, deduped: true }` を返します。それより後の繰り返しは、最初の実行のジョブで `202 { jobId }` を返します。どちらの場合も、新しく開始や課金されるものはありません。キーがない場合、リクエストはすべて新しい実行になります。

## フル品質
完了した Nodaro Prism の**ドラフト**は、**フル品質**で仕上げられます。ドラフトとは、`draft: true` を付けて 480p で作った Video Remake またはトレンドの実行です。フル品質では、同じテイクを 1080p で再レンダリングし、クリップに合わせ、クリップの元の音声を付けます。結果はドラフトにリンクされた新しいジョブで、ドラフト自体はそのまま残ります。

フル品質があるのはドラフトだけです。`draft: true` を付けずに作った 480p の実行を含め、通常の実行は `409 not_a_draft` で拒否されます。480p のテイクを後で 1080p に仕上げるには、`draft: true` を付けて作ってください。Nodaro Pulse はドラフトを作らないので、フル品質はありません。代わりに 1080p でもう一度実行してください。この変更より前に作られた Pulse のフル品質は、独立した実行として一覧に残ります。

見積もりの `kind` は `"same-take"` です。古いサーバーは `kind` を返しませんが、意味は同じです。フル品質は、ドラフトの完了から 7 日間利用できます。

| メソッド | パス | 動作 |
| --- | --- | --- |
| `POST` | `/v1/video-remake/:jobId/full-quality/estimate` | 見積もります。無料で、何も作成も確保もされません。`{ kind, totalCredits, breakdown, availableUntil }` を返します。 |
| `POST` | `/v1/video-remake/:jobId/full-quality` | 開始します。`202 { jobId }` を返します。この実行のフル品質がすでに実行中か完了している場合は `200 { jobId, existing: true }` を返し、新しく開始や課金されるものはありません。任意のボディ `{ sessionId }` を受け取ります。 |

`:jobId` は、ドラフトのジョブ ID です。見積もりでは、`totalCredits` は、フル品質のジョブ自体のステップである `breakdown.base` と、ドラフトのテイクを 1080p でレンダリングする `breakdown.motionHd` の合計です。このドラフトの以前の失敗した試行ですでにそのレンダリングが終わっている場合、`motionHd` は 0 です。レンダリングが再利用され、仕上げの分だけが請求されます。`availableUntil` は、7 日間が終わる日時です。料金はドラフトによって変わるので、先に見積もってください。

フル品質は、1 つのドラフトにつき 1 つです。ジョブはドラフトをキーにしているため、繰り返しや同時のリクエストには同じジョブが返り、`Idempotency-Key` は使われません。失敗またはキャンセルされた試行は、何回かもう一度依頼できます。新しいジョブはドラフトの `origin` を引き継ぎ、`sessionId` で自分のセッションの 1 つに保存されます。

拒否はすべて、何かが課金される前に行われます。ボディは `{ error: { code, message } }` です。

| ステータス | `code` | 条件 |
| --- | --- | --- |
| `401` | `unauthorized` | 認証されたユーザーがいません。 |
| `402` | `insufficient_credits` | クレジットが足りません。開始のみです。ワークスペースでは、代わりに拒否した上限が返ることがあります：`budget_exceeded`、`member_cap_exceeded` または `user_allowance_exceeded`。 |
| `404` | `not_found` | 自分のジョブではないか、Video Remake の実行ではありません。開始のみ、あなたが使えない `sessionId` の場合もです。 |
| `409` | `not_completed` | 実行が完了していません。 |
| `409` | `not_a_draft` | 実行が Nodaro Prism のドラフトではありません。`draft: true` を付けずに作った 480p の実行を含む通常の実行か、ドラフトを作らない Nodaro Pulse の実行です。Pulse は 1080p でもう一度実行してください。 |
| `409` | `full_quality_pending` | 最終的なものではないので、後でもう一度試してください。ボディには `retryable: true` が含まれます。このドラフトの以前の試行の 1080p レンダリングが審査中か、まだ始まっていません。 |
| `409` | `full_quality_unavailable` | 最終的なものです。この実行はフル品質で仕上げられません。再レンダリングのために何も保持されていない、完了時刻を読み取れない、または 1080p の仕上げがこのドラフトを拒否した場合です。開始のみ、すべての試行が失敗した場合や、この実行で試行を開始できない場合もです。 |
| `410` | `draft_expired` | ドラフトの完了から 7 日を超えたか、ドラフトをフル品質で仕上げられなくなりました。 |
| `422` | `job_blocked` | リクエストが、デプロイのジョブポリシーによってブロックされました。開始のみです。 |
| `503` | `job_read_failed` | 現在、ドラフトを読み取れませんでした。ボディには `retryable: true` が含まれます。もう一度試してください。 |
| `503` | `estimate_unavailable` | 現在、1080p のレンダリングを見積もれません。少し後でもう一度試してください。 |
| `503` | `host_too_old` | このプラットフォームのバージョンでは、フル品質を実行できません。 |

`full_quality_pending` と `full_quality_unavailable` は、メッセージではなくコードで区別してください。

## エラー
拒否はすべて、何かが課金される前に行われます。ボディは `{ error: { code, message } }` です。

| ステータス | `code` | 条件 |
| --- | --- | --- |
| `400` | `validation_error` | ボディが有効ではありません。画像のあるロールもリファレンスも `prePrompt` も `postPrompt` もアートスタイルもない（アートスタイルが数えられるのは `styleOnly` が `true` の場合だけです）、リファレンスが 5 個を超える、画像がない、または 3 枚を超えるリファレンスがある、ある種類のロールが許可された数より多い、ロールの画像が 3 枚を超える、画像が合計 30 枚を超える、720p または 1080p で `draft: true`、`prePrompt` か `postPrompt` が 4,000 文字を超える、`origin` が無効、または `style` が `"precise"` でも `"motion"` でもない場合です。 |
| `400` | `draft_unsupported` | ドラフトのない `engine: "nodaro-pulse"` で `draft: true` を指定しています。 |
| `400` | `resolution_unsupported` | `engine: "nodaro-pulse"` で `resolution: "480p"` を指定しています。 |
| `400` | `output_format_unsupported` | `engine: "nodaro-pulse"` に MOV の出力を求めています。MOV を返せるのは Nodaro Prism の実行だけです。 |
| `400` | `too_many_images` | Nodaro Pulse の実行で、すべてのロールと固定のリファレンスを合わせた画像が 10 枚を超えています。 |
| `400` | `raw_reference_token` | ロールの `name` か `previewName`、リファレンスの `line`、`prePrompt`、または `postPrompt` に、生のリファレンストークン（`{image:`、`{video:` または `{audio:`、大文字小文字を問わず）が含まれています。 |
| `400` | `invalid_role_mention` | `prePrompt` か `postPrompt` が、1 からロールの数までの範囲外の N で `{role:N}` を指定しています。リファレンスの `line` にある `{role:N}` も同様です。 |
| `400` | `no_roles_in_preview` | 何も変えないプレビューです。送る内容で判断されます。画像があってプレビューに残るロールも、固定のリファレンスも、`prePrompt` も `postPrompt` も、アートスタイルもない場合です。すべてのロールを外したプレビューでも、リファレンス、プロンプト、または `styleOnly` が `true` の場合のアートスタイルがあれば実行されます。 |
| `400` | `prompt_too_long` | プロンプトが長くなりすぎます。画像のないロールでは `{role:N}` がロールの名前として読まれるため、4,000 文字以内のプロンプトでも、合計がエンジンの上限を超えることがあります。Nodaro Pulse の上限は 8,000 文字です。 |
| `400` | `unsafe_url` | `videoUrl`、ロールの画像、またはリファレンスの画像が、公開された http または https のアドレスではありません。 |
| `400` | `video_unreadable` | クリップの長さを読み取れませんでした。再生できる動画ではありません。 |
| `400` | `clip_out_of_range` | クリップが 4 秒より短いか、30 秒より長いです。 |
| `400` | `clip_too_long_for_style` | `style: "motion"` のみで、Nodaro がモーションの実行をエンジン向けに準備する方法によってクリップが制限されている間です。クリップが 27.9 秒を超えるフル実行です。メッセージは「This clip is too long for Motion. Use a shorter clip or choose Precise.」（このクリップはモーションには長すぎます。短いクリップを使うか、精密を選んでください）です。 |
| `400` | `prompt_parts_not_allowed` | ボディが `promptParts` を送っています。これを送れるのは、トレンドのプロンプトのために Nodaro プラットフォーム自身だけです。 |
| `400` | `prompt_style_not_allowed` | ボディが `promptStyle` を送っています。これを送れるのは Nodaro プラットフォーム自身だけです。実行の文言は、その `style` に従います。 |
| `400` | `preview_out_of_range` | プレビューがクリップの終わりを越えています。`previewStart` に 4 を足した値は、クリップの長さ以下でなければなりません。 |
| `400` | `unnamed_role_needs_picture` | `name` も画像もない人物、ペット、商品のロールです。名前のないロールは最初の画像で名前が付けられるため、画像が必要です。 |
| `400` | `art_style_needs_prism` | アートスタイルを受け付けない `engine: "nodaro-pulse"` でのアートスタイルです。 |
| `400` | `art_style_needs_flex` | `preciseArtStyle` が `true` ではない場合の精密の実行、トレンドの実行、または Nodaro の設定によってプロンプトが精密になるモーションの実行でのアートスタイルです。 |
| `400` | `unknown_art_style` | `direction.style` がスタイルピッカーのカタログの ID ではありません。 |
| `400` | `art_style_not_supported` | `direction` が保存したムードボードを指定しています。Video Remake の実行はこれを受け付けません。 |
| `400` | `role_name_required` | 名前のないロールを含むトレンドの実行です。トレンドのロールには、常に名前が付いています。 |
| `401` | `unauthorized` | 認証されたユーザーがいません。 |
| `402` | `insufficient_credits` | クレジットが実行の料金に足りません。`POST /v1/video-remake` のみです。見積もりに `privacyCredits` がある場合、必要なクレジットは確保分に `privacyCredits` を足した額です。ワークスペースでは、代わりに拒否した上限が返ることがあります：`budget_exceeded`、`member_cap_exceeded` または `user_allowance_exceeded`。 |
| `404` | `not_found` | `sessionId` が、あなたが使えないセッションを指しています。`POST /v1/video-remake` のみです。 |
| `422` | `job_blocked` | リクエストが、デプロイのジョブポリシーによってブロックされました。`POST /v1/video-remake` のみです。 |
| `503` | `host_too_old` | このプラットフォームのバージョンでは Video Remake を実行できません。 |
| `503` | `estimate_unavailable` | 現在、料金を見積もれません。少し後でもう一度試してください。`/estimate` のみです。 |

## SDK から
`client.videoRemake` はすべてのルートをラップします。`@nodaro/sdk/video-remake` としてインポートすることもできます。

```ts
run(params: VideoRemakeParams, options?: { idempotencyKey?: string }): Promise<{ jobId: string; deduped?: boolean }>
estimate(params: VideoRemakeParams): Promise<VideoRemakeEstimate>
fullQualityEstimate(jobId: string): Promise<VideoRemakeFullQualityEstimate>
fullQuality(jobId: string, params?: { sessionId?: string }): Promise<VideoRemakeFullQualityResult>
styleChoice(): Promise<VideoRemakeStyleChoice> // GET /v1/video-remake/style-choice, public
```

`VideoRemakeParams` は上記のリクエストボディで、`engine` は `VideoRemakeEngine` 型、`style` は `VideoRemakeStyle` 型（`"precise" | "motion"`）、`motionLength` は `VideoRemakeMotionLength` 型です。`faceMasking` は古いコードが動き続けるように型として残っていますが、非推奨で、サーバーはこれを無視します。`VideoRemakeEstimate` は見積もりです。`run()` は `idempotencyKey` をそのまま `Idempotency-Key` ヘッダーとして送ります。指定しない場合、ヘッダーは送られません。`styleChoice()` は `VideoRemakeStyleChoice`、つまり `{ engines: { "nodaro-prism", "nodaro-pulse" }, styleOnly?, preciseArtStyle? }` を返します。各エンジンは `VideoRemakeStyleChoiceOption` で、`"user"`、`"precise"` または `"flex"` です。`styleOnly` と `preciseArtStyle` は、各エンジンを boolean に対応させます。値がない場合は `false` として読んでください。`VideoRemakeParams` は `direction?: { style: string }` を受け取り、見積もりの `breakdown` には `referenceAudio` が含まれることがあります。

```ts
const { engines, styleOnly } = await client.videoRemake.styleChoice()
if (styleOnly?.["nodaro-prism"] === true) {
await client.videoRemake.run({ videoUrl, roles: [], style: "motion", direction: { style: "pop-art" } })
}
```

```ts
const params: VideoRemakeParams = {
videoUrl,
roles: [{ kind: "person", name: "the woman dancing", images: [myPhotoUrl], outfit: "original" }],
preview: true,
resolution: "480p",
}
const quote = await client.videoRemake.estimate(params)
const { jobId } = await client.videoRemake.run(params, { idempotencyKey: crypto.randomUUID() })
```

`client.jobs.get(jobId)` でジョブを追跡します。プレビューのジョブは、すべての入力を `input_data` に保持します。そのため、`preview: false` でもう一度実行すれば、同じ選択でクリップ全体をレンダリングできます。

実行を 1080p で仕上げるには、無料の `fullQualityEstimate(draftJobId)` で見積もってから、`fullQuality(draftJobId)` を呼び出します。見積もりの `kind`（`VideoRemakeFullQualityKind`）は `"same-take"` です。結果は `{ jobId, existing? }` です。`existing: true` は、この実行のフル品質がすでに実行中か完了していて、何も課金されなかったことを意味します。拒否には `VideoRemakeFullQualityRefusalCode` が含まれます。`full_quality_pending` の場合、`err.details.retryable` は `true` です。後でもう一度試してください。

```ts
const quote = await client.videoRemake.fullQualityEstimate(draftJobId) // free
const { jobId, existing } = await client.videoRemake.fullQuality(draftJobId)
```

## CLI から
```bash
nodaro video-remake full-quality estimate <jobId> [--json]
nodaro video-remake full-quality run <jobId> [--session <id>] [--json]
```

`estimate` は無料の見積もりです。クレジット、見積もりの各部分、実行を仕上げられる期限を表示します。`run` はクレジットを使い、新しいジョブ ID を表示します。フル品質がすでにある場合、`run` はそのジョブを表示し、何も課金しません。`full_quality_pending` は最終的なものではありません。後でもう一度コマンドを実行してください。

## MCP から
MCP ツールは [`video_remake`](https://nodaro.ai/docs/mcp/tools/video#video_remake) です。同じフィールドをスネークケースで受け取ります。たとえば `pre_prompt`、`prepare_references`、`in_preview`、`engine`、`style`、`motion_length` です。`art_style` も受け取ります。これは Nodaro Prism でのアートスタイルで、[スタイル](https://nodaro.ai/docs/nodes/creative-controls/style)ピッカーのカタログの ID（`pop-art` など）です。モーションの実行と、エンジンが受け付ける場合は精密の実行で使えます。ロールの画像もリファレンスもない場合は、エンジンがスタイルのみの実行を受け付けるなら、クリップ全体のスタイルを変えます。[`video_remake`](https://nodaro.ai/docs/mcp/tools/video#video_remake) を参照してください。クリップの準備に関する設定は受け取りません。`confirm` を指定しない場合は、見積もりを返し、何も課金しません。ユーザーが料金を承認した後に `confirm: true` で呼び出すと、実行を開始してジョブ ID を返します。ツール `estimate_full_quality` と `full_quality` は、ドラフト、または 720p の Nodaro Pulse の実行のフル品質版を見積もり、開始します。

## よくある質問

### Video Remake では何ができますか？

Video Remake は、短い動画の人物、ペット、商品、場所を、あなた自身のリファレンス画像に置き換えます。動画の動き、構図、タイミング、音声はそのまま残り、結果の長さはクリップと同じです。

### Video Remake はモーションコントロールやキャラクタースワップのことですか？

はい。Video Remake は、よく AI モーションコントロールやキャラクタースワップと呼ばれるものです。クリップの動き、構図、タイミング、音声はそのまま残り、そこに映る人物、ペット、商品、場所があなたの画像から作られます。1 枚の静止画のキャラクターに動画の動きをさせる場合は、モーション転送ノードを使います。

### 元の動画は、どのくらいの長さまで使えますか？

4〜30 秒です。これより短いクリップや長いクリップは、何も課金される前に clip_out_of_range で拒否されます。

### Video Remake の実行にかかる料金は、どうすればわかりますか？

実行するのと同じボディで POST /v1/video-remake/estimate を呼び出します。この呼び出しは無料で、実行の開始時に確保される totalCredits と、実行に請求される見込みの額である expectedCredits を返します。内訳の合計ではなく、この 2 つの合計を読んでください。

### クリップ全体をレンダリングする前に、仕上がりを試せますか？

はい。preview を true にして送ると、クリップの previewStart から 4 秒をレンダリングします。プレビューは料金が安く、そのジョブはすべての入力を保持するので、preview を false にしてもう一度実行できます。

### ドラフトの実行をフル品質で仕上げられますか？

はい。ドラフトの完了から 7 日以内であれば仕上げられます。Nodaro Prism で、draft を true にして 480p で実行を作ってください。その後、POST /v1/video-remake/:jobId/full-quality が同じテイクを 1080p で再レンダリングし、新しいジョブにします。先に見積もりのルートで、無料で見積もってください。

### Video Remake では、どのエンジンを使えますか？

2 つです。Nodaro Prism がデフォルトで、480p、720p または 1080p でレンダリングし、draft を true にして送ると 480p のドラフトを作ります。engine を nodaro-pulse にして送ると Nodaro Pulse を使います。Nodaro Pulse は 720p または 1080p でレンダリングし、ドラフトはなく、クリップとあなたの画像をもとに新しいテイクを作ります。

### クリップ内の顔をマスクするかどうかを選べますか？

いいえ。ソースクリップの準備のしかたは、顔を先に隠すかどうかも含めて、Nodaro がエンジンごとに設定します。古いクライアントが送る faceMasking フィールドは受け付けられ、無視されます。

### Video Remake は、セルフホスティング環境で使えますか？

いいえ。Video Remake は Nodaro Cloud でのみ動作します。セルフホスティング環境では、すべてのルートが 404 を返します。
