動画モデル

higgsfield-genjutsu-object-swap

動画カタログのモデル ID は higgsfield-genjutsu-object-swap です。モデル一覧から同じ種類のモデルを比較できます。

使用前に確認すること

下の入力表は router が扱う共通パラメータです。すべての設定をこのモデルへ同時に渡せるという意味ではありません。利用するワークスペースのカタログ行で対応入力・値・組み合わせを確認し、対応する設定だけを送信してください。

GET /v1/creative/video-router/models/{model_id} で一行を取得します。data.model.capabilities と data.model.constraints を確認してから、生成要求を組み立てます。

curl 'https://api.orchestor.io/v1/creative/video-router/models/higgsfield-genjutsu-object-swap' \
  -H "Authorization: Bearer $ORCHESTOR_API_KEY"

生成の手順と結果の受け取り方は動画生成を参照してください。

入力パラメータ

フィールド型指定意味値と制約
modelstring必須このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。固定値 "higgsfield-genjutsu-object-swap"
promptstring任意生成する内容、または編集で変更したい内容を記述する文章。minLength: 1
image_urlstring任意動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。format: "uri"
end_image_urlstring任意動画の最後のフレームの公開 HTTPS URL。image_url と組み合わせて指定します。format: "uri"
video_urlstring任意編集・延長などの入力動画の公開 HTTPS URL。format: "uri"
motion_video_urlstring任意モーション元の動画。motion control モデルのみformat: "uri"
character_orientationstring任意video は動作参照動画、image は静止画の構図を優先します。"image", "video"
keep_original_soundboolean任意true では動作参照動画の音声を残し、false では無音にします。モデルの capabilities と constraints で確認
reference_images(string / object)[]任意参照画像を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。maxItems: 30
reference_images[].typestring必須参照入力の渡し方。URL、アセット ID、Base64 を区別します。"url", "asset_id", "base64"
reference_images[].urlstring任意参照メディアを取得できる URL。URL 形式で渡す場合に使用します。maxLength: 2048; format: "uri"
reference_videos(string / object)[]任意参照動画を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。maxItems: 10
reference_videos[].typestring必須参照入力の渡し方。URL、アセット ID、Base64 を区別します。"url", "asset_id", "base64"
reference_videos[].urlstring任意参照メディアを取得できる URL。URL 形式で渡す場合に使用します。maxLength: 2048; format: "uri"
reference_audio(string / object)[]任意参照音声を URL または種類付きのオブジェクトで指定します。モデルごとの上限と合計上限は capabilities を確認してください。maxItems: 50
reference_audio[].typestring必須参照入力の渡し方。URL、アセット ID、Base64 を区別します。"url", "asset_id", "base64"
reference_audio[].urlstring任意参照メディアを取得できる URL。URL 形式で渡す場合に使用します。maxLength: 2048; format: "uri"
resolutionstring任意出力の解像度。モデルが対応する値をカタログで確認します。"360p", "480p", "540p", "720p", "768p", "1080p", "2K", "2k", "4K", "4k", "8K", "hd", "fhd"
duration_secondsinteger任意生成する動画の長さを秒で指定します。共通範囲は 1〜600 秒で、モデルごとの範囲も適用されます。minimum: 1; maximum: 600
aspect_ratiostring任意出力の幅と高さの比。auto は入力画像に合わせます。モデルの対応値を確認してください。"auto", "adaptive", "21:9", "2:1", "16:9", "4:3", "1:1", "3:4", "9:16", "3:2", "2:3", "9:21"
generate_audioboolean任意対応するモデルで動画と同時に音声を生成するかどうか。モデルの capabilities と constraints で確認
metadataobject任意利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。モデルの capabilities と constraints で確認
modestring任意async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。"async", "sync", "subscribe", "webhook", "text_to_video", "image_to_video", "reference_to_video", "t2v", "i2v", "ref2va"; default: "async"
webhook_urlstring任意終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。maxLength: 2048; format: "uri"
wait_timeout_secondsinteger任意HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。minimum: 0; maximum: 30
project_idstring任意ジョブまたは配置先を関連付けるプロジェクトの ID。maxLength: 200
seedinteger任意再現性の調整に使う乱数シード。0〜4,294,967,295。minimum: 0; maximum: 4294967295
taskstring任意auto- の自動モデル選択に渡す制作意図。名前を指定したモデルでは使用しません。モデルの capabilities と constraints で確認
audio_urlstring任意リップシンク用の音声の公開 HTTPS URL。顔画像には image_url、顔動画には video_url を使い、duration_seconds も指定します。format: "uri"
model_paramsobject任意モデル固有設定の予約領域。現在は省略するか空オブジェクトを指定します。追加のキーは受け付けません。モデルの capabilities と constraints で確認
prompt_enhancementstring任意heygen-video-1 の文章補正。15 秒超では turbo、quality、default を使います。default は turbo と同じ指定です。"turbo", "quality", "ultraquality", "disabled", "default"
end_user_idstring任意heygen-video-1 に渡す利用者の不透明な ID。1〜128 文字、空白と個人情報を含めません。minLength: 1; maxLength: 128
callback_idstring任意heygen-video-1 の追跡用 ID。最大 256 文字で metadata.callback_id に保存し、通知にも含めます。maxLength: 256
draftboolean任意seedance-2.5 で 480p の下書きを作成します。duration_seconds が必須で、video_url、extend、source_duration、draft_job_id は併用できません。モデルの capabilities と constraints で確認
draft_job_idstring任意seedance-2.5 の完了済み下書きの ID。model と、この ID と任意の resolution: 1080p だけを送り、元の入力を引き継ぎます。作成後 14 日以内に使用します。モデルの capabilities と constraints で確認
extendboolean任意seedance-2.5 で video_url の続きを生成します。duration_seconds は追加部分の 4〜30 秒です。モデルの capabilities と constraints で確認
source_durationinteger任意延長する元動画の秒数を切り上げた整数。1〜30。seedance-2.5 の extend で使用し、省略時は 15 秒として料金を計算します。minimum: 1; maximum: 30
dubbingobject任意veed-dubbing の翻訳吹替設定。video_url と 2〜600 秒の duration_seconds が必要で、prompt・resolution・aspect_ratio は指定しません。必須の子項目: target_language
dubbing.target_languagestring必須吹替先の言語。ko などの BCP 47 基本言語タグで、地域付きのタグは指定できません。モデルの capabilities と constraints で確認
dubbing.source_languagestring任意入力動画の言語。省略または auto で自動判定します。モデルの capabilities と constraints で確認
captionsobject任意veed-subtitles の字幕設定。video_url と 2〜600 秒の duration_seconds が必要です。課金対象は最低 60 秒、既定の resolution は 1080p です。必須の子項目: style
captions.stylestring必須モデルカタログにある字幕のスタイル。動的なスタイルは通常の 2 倍の料金です。モデルの capabilities と constraints で確認
captions.srtstring任意字幕として使う SRT 文字列。最大 100,000 文字。省略時は動画の音声を文字起こしします。maxLength: 100000
captions.positionstring任意字幕の表示位置。top は上、center は中央、bottom は下。"top", "center", "bottom"
captions.shadowstring任意字幕の影の強さ。省略すると選択したスタイルの設定を使います。"none", "min", "mid", "max"
upscaleobject任意topaz-video の拡大・補間設定。video_url と切り上げた 2〜60 秒の duration_seconds が必要です。30 fps 超、または fps の省略時は料金が 2 倍になります。モデルの capabilities と constraints で確認
upscale.factornumber任意縦横それぞれの拡大倍率。1〜4、既定は 2。1 と fps の組み合わせでフレームレートだけを変更できます。minimum: 1; maximum: 4
upscale.fpsinteger任意補間後のフレームレート。16〜60。省略すると入力の値を維持します。minimum: 16; maximum: 60
upscale.modelstring任意Topaz の補正モデル名。既定は Proteus。対応値はカタログで確認します。モデルの capabilities と constraints で確認
backgroundobject任意sam-3.1-video の背景除去設定。prompt で残す対象を示し、video_url と切り上げた 2〜60 秒の duration_seconds を指定します。モデルの capabilities と constraints で確認
background.outputstring任意背景除去の結果。sam-3.1-video は cutout(元動画にマスクを適用)のみ対応し、mask は 400 を返します。既定は cutout。"cutout", "mask"
depthobject任意対応モデルの動画深度マップの描画設定。元動画の秒数を切り上げた duration_seconds と video_url を指定します。モデルの capabilities と constraints で確認
depth.colormapstring任意深度の色付け。既定の grayscale は近くを白、遠くを黒にし、inferno と turbo は色で区別します。"grayscale", "inferno", "turbo"
bitrate_modestring任意出力のビットレート設定。standard または high を対応モデルで使用します。"standard", "high"
frame_images(object)[]任意auto- で使用する開始・終了フレーム。最大 2 件で、image_url と併用できます。maxItems: 2
frame_images[].typestring必須入力メディアの種類。対応する名前のオブジェクトに URL を指定します。"image_url"
frame_images[].image_urlobject必須参照画像の URL を持つオブジェクト。必須の子項目: url
frame_images[].image_url.urlstring必須認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。format: "uri"
frame_images[].frame_typestring必須この画像を first_frame(開始)と last_frame(終了)のどちらに使うか。"first_frame", "last_frame"
input_references(object)[]任意auto- で使用する参照メディア。最大 20 件で、type と同じ種類の URL オブジェクトを指定します。maxItems: 20
input_references[].typestring必須入力メディアの種類。対応する名前のオブジェクトに URL を指定します。"image_url", "audio_url", "video_url"
input_references[].image_urlobject任意参照画像の URL を持つオブジェクト。必須の子項目: url
input_references[].image_url.urlstring必須認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。format: "uri"
input_references[].audio_urlobject任意参照音声の URL を持つオブジェクト。必須の子項目: url
input_references[].audio_url.urlstring必須認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。format: "uri"
input_references[].video_urlobject任意参照動画の URL を持つオブジェクト。必須の子項目: url
input_references[].video_url.urlstring必須認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。format: "uri"

カタログの対応範囲

フィールド型指定意味値と制約
namestring必須選択画面などに表示する名称。モデルの capabilities と constraints で確認
modalitystring必須モデルが生成するメディアの種類。"video"
routingstring必須モデルへの入力の渡し方と呼び出し経路の情報。"pass_through"
gatedboolean任意追加の利用条件を満たす必要があるかどうか。モデルの capabilities と constraints で確認
capabilitiesobject必須テキスト生成・編集・参照入力など、このモデルが対応する機能。必須の子項目: text_to_video, image_to_video, end_frame, reference_images, reference_videos, reference_audios, video_to_video, audio, resolutions, duration_seconds, aspect_ratios
capabilities.max_reference_imagesinteger任意受け付ける参照入力の最大数。minimum: 1
capabilities.max_reference_videosinteger任意受け付ける参照入力の最大数。minimum: 1
capabilities.max_reference_audiosinteger任意受け付ける参照入力の最大数。minimum: 1
capabilities.max_reference_totalinteger任意参照入力の合計の最大数。minimum: 1
capabilities.operation_settingsobject任意Provider-documented settings for each supported generation operation.モデルの capabilities と constraints で確認
capabilities.text_to_videoboolean必須文章から動画を生成できるかどうか。モデルの capabilities と constraints で確認
capabilities.image_to_videoboolean必須最初のフレームとなる画像から動画を生成できるかどうか。モデルの capabilities と constraints で確認
capabilities.end_frameboolean必須最後のフレームを画像で指定できるかどうか。モデルの capabilities と constraints で確認
capabilities.reference_imagesboolean必須参照画像入力への対応条件。モデルの capabilities と constraints で確認
capabilities.reference_videosboolean必須参照動画入力への対応条件。モデルの capabilities と constraints で確認
capabilities.reference_audiosboolean必須参照音声入力への対応条件。モデルの capabilities と constraints で確認
capabilities.video_to_videoboolean必須入力動画を編集できるかどうか。モデルの capabilities と constraints で確認
capabilities.audioboolean必須音声の生成または入力への対応条件。モデルの capabilities と constraints で確認
capabilities.resolutions(string)[]必須このモデルで指定できる出力解像度の一覧。モデルの capabilities と constraints で確認
capabilities.duration_secondsobject必須指定可能な動画の秒数。モデルごとの範囲を確認してください。必須の子項目: min, max
capabilities.duration_seconds.mininteger必須許可される値の下限。モデルの capabilities と constraints で確認
capabilities.duration_seconds.maxinteger必須許可される値の上限。モデルの capabilities と constraints で確認
capabilities.aspect_ratios(string)[]必須このモデルで指定できる縦横比の一覧。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_modeobject任意生成方式ごとの動画の長さの制約。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.text_to_videoobject任意文章から動画を生成できるかどうか。必須の子項目: min, max
capabilities.duration_seconds_by_mode.text_to_video.mininteger必須許可される値の下限。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.text_to_video.maxinteger必須許可される値の上限。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.image_to_videoobject任意最初のフレームとなる画像から動画を生成できるかどうか。必須の子項目: min, max
capabilities.duration_seconds_by_mode.image_to_video.mininteger必須許可される値の下限。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.image_to_video.maxinteger必須許可される値の上限。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.reference_to_videoobject任意参照メディアを使って動画を生成できるかどうか。必須の子項目: min, max
capabilities.duration_seconds_by_mode.reference_to_video.mininteger必須許可される値の下限。モデルの capabilities と constraints で確認
capabilities.duration_seconds_by_mode.reference_to_video.maxinteger必須許可される値の上限。モデルの capabilities と constraints で確認
capabilities.seedboolean任意再現性の調整に使う乱数シード。0〜4,294,967,295。モデルの capabilities と constraints で確認
capabilities.motion_controlboolean任意動作参照動画のモーションをキャラクター画像に適用できるかを示します。モデルの capabilities と constraints で確認
capabilities.upscaleboolean任意元の動画の解像度やフレームレートを上げられるかを示します。モデルの capabilities と constraints で確認
capabilities.lipsyncboolean任意入力音声に合わせて映像内の口の動きを調整できるかを示します。モデルの capabilities と constraints で確認
capabilities.captionsboolean任意動画への字幕の追加に対応しているかを示します。モデルの capabilities と constraints で確認
constraints(string)[]必須モデルごとに受け付ける解像度、入力数、長さなどの制約。モデルの capabilities と constraints で確認

料金の形状

金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。

フィールド型指定意味値と制約
basisstring必須画像数、秒数、解像度など、単価を適用する基準。"per_1000_video_tokens", "per_second", "per_second_by_resolution"
credits_per_1000_video_tokensnumber任意動画トークン 1,000 個あたりの消費クレジット。minimum: 0
credits_per_secondnumber任意動画 1 秒あたりの消費クレジット。minimum: 0
credits_per_second_audio_onnumber任意音声生成を有効にした場合の動画 1 秒あたりの消費クレジット。minimum: 0
credits_per_second_by_resolutionobject任意解像度ごとの動画 1 秒あたりの消費クレジット。モデルの capabilities と constraints で確認
usd_per_secondstring任意動画 1 秒あたりの USD 単価。pattern: "^\\d+\\.\\d{4,}$"
usd_per_second_audio_onstring任意音声生成を有効にした場合の動画 1 秒あたりの USD 単価。pattern: "^\\d+\\.\\d{4,}$"
usd_per_second_by_resolutionobject任意解像度ごとの動画 1 秒あたりの USD 単価。モデルの capabilities と constraints で確認
usd_options(object)[]任意生成オプションによる USD 単価の差。モデルの capabilities と constraints で確認
usd_options[].labelstring必須画面に表示する項目の名前。モデルの capabilities と constraints で確認
usd_options[].resolutionstring任意出力の解像度。モデルが対応する値をカタログで確認します。モデルの capabilities と constraints で確認
usd_options[].audioboolean任意音声の生成または入力への対応条件。モデルの capabilities と constraints で確認
usd_options[].qualitystring任意モデルが受け付ける生成品質。対応する値はカタログで確認します。モデルの capabilities と constraints で確認
usd_options[].usdstring必須指定した処理の料金。単位は USD。pattern: "^\\d+\\.\\d{4,}$"