Source: https://ailoot.ai/models/ja/dop-preview/
Canonical: https://ailoot.ai/models/ja/dop-preview/
Language: ja

# Higgsfield: DOP Preview

[Markdown](https://ailoot.ai/models/ja/dop-preview/index.md) · [JSON](https://ailoot.ai/models/ja/dop-preview/facts.json)

## [Higgsfield: DOP Preview](https://ailoot.ai/models/ja/dop-preview/)

DOP Previewは、文書化された動作テンプレートのワークフローで、提示した画像を動画に変えます。正確なdop-preview指定は一つまたは二つの効果をサポートし、強度、prompt、seedの設定を完成結果と一緒に保持します。

- [**Ailoot Ultra · 動画** `POST /v1/videos` `dop-preview`](https://ailoot.ai/models/ja/dop-preview/#method-0)

モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

DOP Previewは、Higgsfieldが文書化している画像から動画へのワークフローで、提示した画像を動かします。正確なモデル指定はdop-previewです。トップレベルのモデル選択と、文書化されたparamsオブジェクト内のmodelの値の両方にdop-previewを使います。画像が視覚素材を提供し、動作テンプレートと文章による指示が、求める動きや効果を制御します。

意図する被写体、重要な詳細、周囲の空間を読み取れる参照画像を用意します。ガイドは、詳細をより明瞭にするために高解像度の画像を推奨しています。商品シーンでは、物体の形と、動いている間も認識できる状態を保つべき表面が見える構図を選びます。人物や環境では、動きによって強調すべき視覚的特徴を指定します。メソッドの例で使われている画像入力を通じて、実際の参照画像URLを渡します。

この操作では、一つまたは二つの動作テンプレートが文書化されています。二つを指定した場合、ガイドはそれらの効果が組み合わされると説明しています。プリセットの説明には、カメラの動き、被写体の回転、見た目の変化が含まれます。たとえばDolly Inはカメラが近付く動き、3D Rotationは被写体や商品がその場で回転する動きです。意図する流れに合う文書化済みのテンプレート識別子を選び、各識別子とその強度値を一緒に保持します。

動きの強度は0から1までの数値で、文書化された既定値は0.8です。ガイドは0.3を控えめな効果、1を強い動きとして説明しています。読み取れる状態を保つ必要がある詳細に応じて強さを選び、生成された動作全体を確認します。動作の説明と強度には別々の役割があり、テンプレートが効果を選び、強度がその強さを制御します。

説明によるとpromptフィールドの指定は必須ですが、空文字列も許可されています。テンプレート主導の効果ではpromptを空にすることが推奨されます。文章を指定する場合、promptが結果を大きく変えることがあるため、テンプレートの説明を含めることが推奨されています。enhance\_promptはプロンプト最適化を有効にする設定で、文書化された既定値はtrueです。複数の版を比較する際は、文章とこの設定を、参照画像および選択したテンプレートと一緒に保持します。

seedは1から1000000までの整数を受け付けます。選択したseedを生成設定と一緒に記録します。リクエストには整数のsecondsフィールドもあり、指定値を生成されたクリップと一緒に保持し、実際の長さとフレーミングを確認します。check\_nsfwは文書化されたコンテンツフィルターを有効にする真偽値で、既定値はtrueです。これらの設定は画像から動画へのリクエストに属し、実際に選択したモデルとの対応を保つ必要があります。

生成は非同期です。設定されたステータス確認と結果照会を進める間、返されたタスクの識別情報を保持します。完了結果の対応付けでは、完了済みジョブのエントリとその生の結果URLを読み取ります。完了した動画結果をすべて保存し、ジョブ識別子と返却URLを対応させます。完了したすべてのエントリを、その操作の結果としてまとめて保持します。

動画全体を、提示した画像、選択した効果、文章による指示に照らして確認します。対象は被写体の見た目、動き、構図、最後の画面です。修正では、変更する具体的な視覚上の詳細を特定し、リクエストのうまくいった部分を保持します。元の画像参照、正確なモデル指定、prompt、動作識別子、強度、seed、要求した設定、完成した素材を一緒に保持し、次の比較を実際の生成結果に基づいて行えるようにします。

**Ailoot Ultra · 動画** `POST /v1/videos` `dop-preview`

[`dop-preview`](https://ailoot.ai/models/ja/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

Higgsfield /`dop-preview`

### はじめに

DOP Previewは、文書化された動作テンプレートのワークフローで、提示した画像を動画に変えます。正確なdop-preview指定は一つまたは二つの効果をサポートし、強度、prompt、seedの設定を完成結果と一緒に保持します。

対応する入力

画像 · テキスト

結果

動画

### Ailootで利用可能 · 入力とメソッド

**Ailoot Ultra · 動画** `POST /v1/videos`

入力の種類

`image`, `text`

出力の種類

`video`

| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
| --- | --- | --- | --- | --- |
| フィールド`model` | 種類`string` | 要件必須 | 値と制限 dop-preview 条件: Ailootのモデル指定子。 | デフォルト— |
| フィールド`params` | 種類`object` | 要件必須 | 値と制限 条件: 画像から動画を生成するためのパラメーター。この外側の構造を維持してください。 | デフォルト— |
| フィールド`params.model` | 種類`string` | 要件必須 | 値と制限 dop-preview 条件: 最上位のmodelと同じ指定子を使用してください。 | デフォルト— |
| フィールド`params.prompt` | 種類`string` | 要件必須 | 値と制限 条件: このフィールドを省略しないでください。文書では空文字列が認められています。テキストによる指示は、選択した動きの効果に大きく影響します。 | デフォルト— |
| フィールド`params.seconds` | 種類`integer` | 要件任意 | 値と制限 条件: 要求する長さ。文書に記載された範囲やデフォルト値は断定しません。 | デフォルト— |
| フィールド`params.motions` | 種類`array` | 要件任意 | 値と制限 条件: 文書に記載されたモーションテンプレートを一つまたは二つ選択してください。 | デフォルト— |
| フィールド`params.motions[].id` | 種類`string` | 要件必須 | 値と制限 条件: 文書に記載された動作確認済みリクエスト例のモーション識別子。 | デフォルト— |
| フィールド`params.motions[].strength` | 種類`number` | 要件必須 | 値と制限 最小値: 0 最大値: 1 条件: 動きの強さ。0.3は控えめ、1は強い動きと説明されています。 | デフォルト0.8 |
| フィールド`params.input_images` | 種類`array` | 要件任意 | 値と制限 条件: 動作例に示されたimage\_urlオブジェクトの配列で指定する参照画像。 | デフォルト— |
| フィールド`params.input_images[].type` | 種類`string` | 要件必須 | 値と制限 image\_url 条件: 参照データの表現形式。 | デフォルト— |
| フィールド`params.input_images[].image_url` | 種類`string` | 要件必須 | 値と制限 条件: 実際にアクセス可能な参照画像のURL。 | デフォルト— |
| フィールド`params.enhance_prompt` | 種類`boolean` | 要件任意 | 値と制限 条件: プロンプトの改善。 | デフォルトtrue |
| フィールド`params.check_nsfw` | 種類`boolean` | 要件任意 | 値と制限 条件: コンテンツのフィルタリング。 | デフォルトtrue |
| フィールド`params.seed` | 種類`integer` | 要件任意 | 値と制限 最小値: 1 最大値: 1,000,000 条件: 出力の一貫性を保つためのシード。 | デフォルト— |
| フィールド`webhook` | 種類`object` | 要件任意 | 値と制限 条件: 文書に記載された任意のwebhook設定。所有する結果の取得には、Ailootのタスクパスを使用します。 | デフォルト— |
| フィールド`webhook.url` | 種類`string` | 要件任意 | 値と制限 条件: 受信先のURL。 | デフォルト— |
| フィールド`webhook.secret` | 種類`string` | 要件任意 | 値と制限 条件: 受信先のシークレット。 | デフォルト— |
| フィールド`callback` | 種類`string` | 要件任意 | 値と制限 条件: 任意のcallback受信先。文書に記載された受信先はHTTP 200で応答します。 | デフォルト— |

入力素材の組み合わせ

メソッドのパラメータとライフサイクル

| パラメータ | 仕様 |
| --- | --- |
| パラメータ`content_type` | 仕様application/json |
| パラメータ`required` | 仕様model, params |
| パラメータ`optional` | 仕様params.seconds, params.motions, params.input\_images, params.enhance\_prompt, params.check\_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
| パラメータ`material_types` | 仕様image, text |
| パラメータ`additional_properties` | 仕様true |
| パラメータ`validation_scope` | 仕様modelによってリクエストがルーティングされます。parametersの外側の構造は、提示された画像から動画を生成するリクエストに従います。 |

メソッドのエイリアス: `/v1/videos/generations`

ライフサイクル: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`GET /v1/videos/generations/{request_id}/content`

最上位とparams内で同じモデル指定子を使用してください。

作成は一度だけ行い、その後は返された公開idとpolling\_urlを使って元の操作を確認してください。

完了した所有動画をすべて取得し、結果に含まれる実際の長さと寸法を確認してください。

例のYOUR\_ACCESSIBLE\_IMAGE\_URLを、実際の参照画像URLに置き換えてください。

### 料金

##### 最終料金の計算方法

表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。

料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。

高速モード

未指定 高速モードが選択されている場合

Flex モード

未指定 flex モードが選択されている場合

最大推論量

未指定 推論量が最大で、調整に既定値（default）を使用する場合

#### 比較用の推定料金

#### 設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

| 設定 | 料金表 | 予測数量 | 料金 |
| --- | --- | --- | --- |
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 料金 入力 · 入力トークン · 比較専用の見積もり **—** / 1K トークン 出力 · 出力トークン · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり **—** / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり **—** / 1K トークン |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 料金 出力 · 推定生成コスト · 比較専用の見積もり **$1.24** 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。[金額の確保と精算の仕組み →](https://ailoot.ai/docs/ja/billing/reserve/)

### リクエスト例

#### Ailoot Ultra · 動画

JSON · 動画を作成するcurl · 元のタスクを読み取る

```json
{
  "model": "dop-preview",
  "params": {
    "model": "dop-preview",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
```

### 結果を受け取って保存

#### Ailoot Ultra · 動画

返されたジョブと各状態を保持してください。完了した所有動画の結果をすべて読み取ってください。

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

##### 完了した結果をすべて保存

完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。

実際に完了した出力をすべて取得してください。出力数が固定されていると想定しないでください。

##### 元のレスポンスを確認する場合

元のレスポンスと返されたタスクの識別情報を保持してください。未認識の状態や不明確な送信結果は、新しい作成を行う許可にはなりません。

レスポンスのフィールド

| フィールド | 種類 | 意味 |
| --- | --- | --- |
| フィールド`id` | 種類string | 意味公開Ailootタスクまたは操作の識別子。 |
| フィールド`provider_task_id` | 種類string | 意味公開idとは別の、元のタスク識別子。 |
| フィールド`polling_url` | 種類string | 意味返されたAilootの照会パス。 |
| フィールド`jobs[].id` | 種類string | 意味実際に返されたジョブの識別子。 |
| フィールド`jobs[].status` | 種類string | 意味返された各ジョブの状態。 |
| フィールド`jobs[].results.raw.url` | 種類string | 意味完了した各動画は、Ailootが所有する署名付きURLで提供されます。 |

エラーと次の手順

| レスポンス | 条件 | 次の手順 |
| --- | --- | --- |
| レスポンス400 · `invalid_request_error` | 条件JSON／モデル、またはコンテンツのインデックスが無効です。 | 次の手順 |
| レスポンス401 · `authentication_error` | 条件Ailoot APIキーが無効です。 | 次の手順 |
| レスポンス403 · `permission_error` | 条件このAPIキーのグループには、このメディアルートを利用する権限がありません。 | 次の手順 |
| レスポンス404 · `not_found_error` | 条件元のタスクまたは要求された出力が存在しないか、同じユーザー／APIキー／グループの所有物ではありません。 | 次の手順 |
| レスポンス502 · `result_pending_check` | 条件元の送信またはステータスが不完全、あるいは照合できません。元のIDを保持し、再送信しないでください。 | 次の手順 |
| レスポンス503 · `result_pending_check` | 条件元の紐付け、ルート、または所有メディアを引き続き確認しています。その元の操作の確認を続けてください。 | 次の手順 |
| レスポンス503 · `server_error` | 条件メディアサービス、または元のタスクの保存領域を利用できません。 | 次の手順 |

### エイリアス

#### モデルのエイリアス

**Ailoot Ultra** [`dop-preview`](https://ailoot.ai/models/ja/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

#### メソッドパスのエイリアス

`/v1/videos/generations`

#### 関連する呼び出し用ID

[`dop-preview`](https://ailoot.ai/models/ja/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

FAQ · Higgsfield: DOP Preview

利用できる入力と結果は何ですか？

`POST /v1/videos` · `dop-preview`: `image`, `text` → `video`

リクエストはどの項目を使用しますか？

`POST /v1/videos` · `dop-preview`: `model`, `params`, `webhook`, `callback`

どの制限が適用されますか？

`POST /v1/videos` · `dop-preview`: `params.motions[].strength.minimum`: `0`; `params.motions[].strength.maximum`: `1`; `params.seed.minimum`: `1`; `params.seed.maximum`: `1000000`

AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。

## 企業とそのプロジェクト群

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

## トークンを割引価格で購入。

継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。

サブスクリプション

定期的なリクエストに合う割引プランを選びましょう。

最大50%のプロモコード

購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。

支出を履歴で確認

各リクエストのモデル、トークン、金額が保存されます。

[サブスクリプションを選ぶ](https://ailoot.ai/docs/ja/billing/subscriptions/) · [モデルの価格を見る](https://ailoot.ai/models/ja/)

## 販売する製品に、 APIを組み込みましょう。

SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。

商用アプリ

サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。

リセラーライセンス

プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。

サイトで契約文書を確認

接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

[リセラーライセンスを申請](mailto:support@ailoot.ai) · [サービス提供条件とライセンス契約](https://ailoot.ai/legal/offer?lang=ja)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。