モデル

Higgsfield: DOP Preview

Markdown · JSON

Higgsfield: DOP Preview

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

モデルについて

この説明はモデルの機能を紹介するものです。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

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はリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →

リクエスト例

Ailoot Ultra · 動画

JSON · 動画を作成するcurl · 元のタスクを読み取る
{
  "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
  }
}
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

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

/v1/videos/generations

関連する呼び出し用ID

dop-preview

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%のプロモコード
購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。
支出を履歴で確認
各リクエストのモデル、トークン、金額が保存されます。

サブスクリプションを選ぶ · モデルの価格を見る

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

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

商用アプリ
サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。
リセラーライセンス
プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。
サイトで契約文書を確認
接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

リセラーライセンスを申請 · サービス提供条件とライセンス契約