Seedance からの移行

H3 動画タスク API · /api/v3

方舟の呼び出し方式を維持

H3 は方舟動画タスクプロトコルのうち、テキスト動画と開始フレーム 1 枚の画像動画に対応します。パス、認証、content 構造、状態確認の流れを維持し、サービスアドレス、モデル ID、対応仕様を変更できます。

導入項目	移行時の変更
Base URL	`https://fablun.com/api/v3`
API Key	Fablun の顧客キーに置き換えます。
model	h3-pro または h3-standard を使用します。Seedance のモデル ID は受け付けません。
SDK メソッド	Ark.content_generation.tasks の create / get / list / delete を維持します。
結果の取得	作成時は id、取得時は status と content.video_url を読み取ります。
入力パラメータ	text と 1 枚の first_frame に対応します。提供中の resolution と duration を明示的に指定します。

SDK クライアント

Python · 検証済み SDK 5.0.55

from volcenginesdkarkruntime import Ark
import os

client = Ark(
    base_url="https://fablun.com/api/v3",
    api_key=os.environ["ARK_API_KEY"],
)

互換性の範囲

項目	現在の H3 対応範囲
モデルと入力	2 種類の H3 モデル ID、テキスト、開始フレーム 1 枚の URL / data URL。利用前に提供状況を確認してください。
仕様	480p / 720p、1:1、3:4、4:3、16:9、9:16 に対応し、音声は任意です。動画の長さはモデル表を確認してください。
タスクと再試行	4 種類のタスク操作、6 種類の状態、冪等な再試行に対応します。キュー上限と公平なスケジュールは Fablun のルールに従います。
リンクの有効期間	完了後 1 時間です。火山エンジンの保持ポリシーとは異なります。
SDK	volcengine-ark-runtime 5.0.55 で検証済みです。新しい arkruntime と Seedance の新機能は今回の検証範囲に含まれません。
未対応	1080p、任意のアスペクト比、開始・終了フレーム、マルチモーダル参照、ドラフトモード、flex。

プロトコルの互換性は、モデルの機能、上限、料金、保持期間、実行方式が Seedance と同じであることを意味しません。未対応のパラメータはエラーを返します。

公式プロトコル資料火山方舟 · 動画生成タスクの作成火山方舟 · 動画生成チュートリアル

開始・終了フレーム

H3 Pro の 5 秒動画で開始・終了フレームに対応。480p / 720p、1:1・3:4・4:3・16:9・9:16 が利用できます。各 role は 1 枚、last_frame には first_frame が必要です。動画 1 件として課金し、キャンセル・審査・コールバックは通常のタスクと同じです。出力用 return_last_frame は未対応です。

{
  "model": "h3-pro",
  "content": [
    {
      "type": "text",
      "text": "A red ball rolls from left to right."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://YOUR_IMAGE_HOST/first-frame.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://YOUR_IMAGE_HOST/last-frame.jpg"
      },
      "role": "last_frame"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "generate_audio": true
}