Seedance シリーズ

ByteDance の動画生成モデルで、全 4 モデルです。OfoxAI の動画エンドポイント POST /v1/videos で呼び出します。タスクは非同期で実行され、タスクを作成するとタスク ID が返り、その ID で結果を照会します。

モデルの選び方

ポイント4K 出力が必要なら 2.0、30 秒の長さや 21:9 のアスペクト比が必要なら 2.5、480p・720p の動画をまとめて生成するなら Mini または Fast を選びます。

モデル	解像度（デフォルト）	長さ	アスペクト比
Seedance 2.5	`480p` `720p` `1080p`（`720p`）	4–30 秒	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `adaptive`
Seedance 2.0	`480p` `720p` `1080p` `4k`（`1080p`）	4–15 秒	`16:9` `9:16` `1:1` `adaptive`
Seedance 2.0 Fast	`480p` `720p`（`720p`）	4–15 秒	2.0 と同じ
Seedance 2.0 Mini	`480p` `720p`（`720p`）	4–15 秒	2.0 と同じ

4 モデルとも、テキストから動画、画像から動画、動画参照に対応し、同期した音声トラックを生成できます（generate_audio のデフォルトは true）。adaptive は入力画像の比率をそのまま使うことを表します。

モデル ID（そのままコピーしてください）

Seedance 2.5bytedance/seedance-2.530 秒、21:9

Seedance 2.0bytedance/seedance-2.04K

Seedance 2.0 Fastbytedance/seedance-2.0-fast480p、720p

Seedance 2.0 Minibytedance/seedance-2.0-mini480p、720p

上の表は Models API が返す video_attributes と一致しています。モデルの機能が変更された場合は API の返り値が優先されます。秒単位で課金され、実際の料金はタスク結果の usage.video_cost に従います。価格はモデルページを参照してください。

resolution と duration は明示的に指定してください。 指定しない場合、2.0 のデフォルトは 1080p になり、料金は解像度の tier で計算されるため 720p より高くなります。

呼び出し例

ポイント5 つの生成モードは同じエンドポイントを使い、渡した素材フィールドによってモードが決まります。モードを指定するパラメータは不要です。

以下の例はタスク作成のリクエストのみを示しています。作成後にステータスを照会し、結果をダウンロードするまでの流れは Video API · クイックスタートを参照してください。

テキストから動画

prompt だけを渡します。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "雪原を走るキツネ、カメラが追いかける",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

画像から動画

frame_images に first_frame を 1 枚渡すと、その画像を最初のフレームとする動画が生成されます。アスペクト比を adaptive にすると画像の比率をそのまま使えます。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "画面の犬がカメラに向かって走ってくる",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

最初と最後のフレーム

frame_images に first_frame と last_frame を渡すと、2 つのフレーム間のトランジションが生成されます。last_frame だけを渡すと 400 が返ります。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "つぼみがゆっくりと開き、満開のバラになる",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

参照画像

input_references に画像（最大 9 枚）を渡します。人物、商品、スタイルの一貫性を保つために使われ、固定の画面にはなりません。プロンプトでは「画像 1」「画像 2」のように各画像を指すことをおすすめします。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "画像 1 の女の子が画像 2 のカップを持ち、カフェの窓辺で微笑む",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

音声・動画参照

input_references には画像、音声（最大 3 クリップ、各 15 秒以内）、動画（最大 1 本）を混在させて渡せます。動画を入力にした場合、課金秒数に入力動画の長さが含まれる場合があります。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "キャラクターがこの音声の口調で話し、カメラワークはこの動画を参考にする",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

frame_images と input_references は同時に渡せません。両方を渡すと 400 references_conflict が返ります。
画像には公開 URL のほか、data:image/...;base64, で始まる文字列も使えます。
音声トラックが不要な場合は "generate_audio": false を渡します。
フィールド構造の詳しい説明は動画タスクを作成を参照してください。

実在人物の参照画像

ポイントOfoxAI 経由で呼び出す場合、Seedance の素材ライブラリでの認証は不要です。リクエストのトップレベルに real_person: true を追加するだけです。

ByteDance 公式の Seedance API では、実在人物の顔を含む参照画像や動画を直接アップロードできません。BytePlus Seedance 2.0 公式ドキュメントでは許諾済みの実在人物素材を使うよう求めており、Volcano Engine Ark の実在人物ライブラリガイドには、招待の送信、本人による認証と許諾、素材のアップロード、許諾の受領と素材 ID の取得といった手順が記載されています。

手順	Seedance 公式 API に直接接続	OfoxAI 経由で呼び出し
初回リクエスト前	素材グループの作成、実在人物の認証と許諾、素材のアップロードと検証、素材 ID の取得	プロバイダーのプラットフォームでの事前登録は不要
参照画像の渡し方	有効な許諾済み素材 `asset://<asset_id>` を使用	`frame_images` または `input_references` に画像 URL または `data:` URI を渡す
リクエストの切り替え	審査を通過した素材 URI に置き換える	リクエストのトップレベルに `"real_person": true` を追加


{
  "model": "bytedance/seedance-2.0",
  "prompt": "画面の人物が映画のような夜市を歩く",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

OfoxAI は送信前に参照画像へプライバシー保護の前処理を行います。アップストリームのディープフェイク対策審査による誤拒否を減らせますが、アップストリームでの受理は保証されません。アップストリームで拒否されたタスクは課金されません。
real_person は処理の指示であり、許諾の証明ではありません。法的に利用する権利があり、利用許諾を得た画像だけを送信してください。
画像が拒否され続ける場合の調整方法と前処理のエラーコードは実在人物の参照画像を参照してください。

プロバイダーを指定

ポイントSeedance は 2 つのプロバイダーで提供されており、審査基準が異なります。指定しない場合はゲートウェイが重み付けに従って振り分けます。

プロバイダー	説明	コンテンツ審査
`volcengine`	Volcano Engine Ark、ByteDance の中国国内向けプラットフォーム	標準の審査
`byteplus`	BytePlus、ByteDance の海外向けプラットフォーム	すべての利用者に適しているとは限らない（NSFW）コンテンツを許可

プロバイダーを固定するには、リクエストのトップレベルに次を追加します。


"provider": { "type": "byteplus" }

すべての利用者に適しているとは限らないコンテンツを生成する場合は、byteplus を明示的に指定する必要があります。指定しない場合、リクエストが volcengine に振り分けられ、コンテンツ審査で拒否される可能性があります。プロバイダーを指定した場合、そのプロバイダーが利用できなくても自動で切り替わることはありません。

provider.type の値が誤っている場合は 400 invalid_provider_type が返り、指定したプロバイダーがそのモデルを提供していない場合は 400 provider_type_unavailable が返ります。共通の説明は動画のプロバイダールーティングを参照してください。

よくあるエラー

ポイントパラメータの検証エラーは作成時に返され、タスクは作成されず、料金も発生しません。エラーメッセージには許可される値が示されます。

HTTP · code	エラーメッセージ原文	原因	対処方法
400 `unsupported_parameter`	`duration 3 out of range [4, 15]`	長さがそのモデルの範囲外	2.0 系は 4–15 秒、2.5 は 4–30 秒
400 `unsupported_parameter`	`resolution "1080p" not supported; allowed: [480p 720p]`	Fast と Mini は 1080p に非対応	`720p` に変更するか、2.0 / 2.5 に切り替える
400 `unsupported_parameter`	`resolution "4k" not supported; allowed: [480p 720p 1080p]`	4K に対応しているのは 2.0 のみ	`bytedance/seedance-2.0` に切り替える
400 `unsupported_parameter`	`aspect_ratio "21:9" not supported; allowed: [16:9 9:16 1:1 adaptive]`	2.0 系は 21:9 に非対応	2.5 に切り替えるか、対応する比率に変更する
400 `references_conflict`	`frame_images and input_references are mutually exclusive`	2 種類の素材フィールドを同時に渡した	どちらか一方のみを使用する。呼び出し例を参照
400 `invalid_request`	`frame_images: last_frame requires a first_frame`	最後のフレームだけを渡した	`first_frame` を追加する
400 `too_many_references`	`input_references over limit: images 10/9, audios 0/3, videos 0/1`	参照素材が上限を超えている	画像は最大 9 枚、音声は最大 3 クリップ、動画は最大 1 本
400 `invalid_request`	`real_person requires at least one image reference`	`real_person` を有効にしたが画像を渡していない	画像を追加するか、`real_person` を削除する
400 `invalid_request`	`cannot unmarshal string into Go struct field CreateVideoRequest.duration of type int`	`duration` に `"5s"` のような文字列を渡した	`5` のような整数に変更する
400 `invalid_callback_url`	`callback_url must be a public HTTPS URL`	コールバック先が HTTPS ではない、または内部アドレス	公開 HTTPS アドレスに変更する
404 `model_not_found`	`model not found`	モデル ID のスペルミス（例：`bytedance/seedance-2`）	このページからモデル ID をコピーする
402 `insufficient_credits`	—	残高が見積料金に足りない（タスクは作成されない）	チャージしてから再試行する

タスクの作成に成功した後、生成段階で失敗した場合は、照会結果が status: "failed" になり、失敗の原因は error フィールドに示されます。タイムアウトは error.code: "expired" に対応します。エラーコードの全体は Video API エラーコードを参照してください。

公式ドキュメント

よくある質問

Seedance で最初と最後のフレームを指定した動画を作るには？

frame_images に 2 枚の画像を渡し、1 枚の frame_type を first_frame、もう 1 枚を last_frame にします。last_frame だけを渡すと 400 last_frame requires a first_frame が返ります。frame_images は input_references と同時に渡せません。

Seedance 2.0 は 4K に対応していますか？

4k に対応しているのは bytedance/seedance-2.0 のみです。2.5 は最大 1080p、Fast と Mini は最大 720p です。対応していない解像度を渡すと 400 が返り、エラーメッセージに許可される値が示されます。

Seedance で生成できる最大の長さは？

Seedance 2.5 は 1 タスクあたり 4〜30 秒、2.0、2.0 Fast、2.0 Mini は 4〜15 秒です。範囲を超えると 400 duration out of range が返ります。

Seedance は 21:9 に対応していますか？

21:9 に対応しているのは Seedance 2.5 のみです。2.0 系が対応するのは 16:9、9:16、1:1、adaptive です。

Seedance の参照画像に実在人物が含まれていてエラーになる場合は？

公式 API に直接接続する場合は、事前に素材ライブラリで本人認証を済ませる必要があります。OfoxAI 経由であれば、リクエストのトップレベルに real_person: true を追加するだけで画像を直接渡せ、OfoxAI が先にプライバシー保護の前処理を行います。それでもアップストリームで拒否された場合は課金されず、実在人物の参照画像のページにある方法で画像を調整して再試行できます。

Seedance で一度に渡せる参照画像は何枚までですか？

input_references には画像 9 枚、音声 3 クリップ（各 15 秒以内）、動画 1 本まで渡せます。超えると 400 too_many_references が返ります。

Seedance で生成した動画の URL はいつまで有効ですか？

mirror_urls を優先して使ってください。unsigned_urls だけが返る場合はアップストリームの一時アドレスで、24 時間後に無効になる場合があります。速やかにダウンロードして保存してください。