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はじめに
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 · 動画
{
"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}/contentGET /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
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