seedance-submitter

Seedance Submitter

使用する場合

• PostPlus Cloud 経由で Seedance 2.0/2.5 ジョブを準備、検証、送信、ポーリング、またはデバッグするとき。

使用しない場合

• 必須の入力が欠けており、推測すると結果が変わってしまうとき。
• タスククラス、フックロジック、ストーリーボード、または参照ポリシーがまだ未解決のとき。 先に video-generation と video-request-architect を使用してください。

実行境界

• このランナーは、正規化された Seedance リクエストの検証、送信、ポーリングを行います。クリエイティブ戦略、タスク分類、参照ポリシーの決定を行ってはなりません。
• ユーザーが別のモデルを指定しない限り、sd2 は現在のデフォルト層である Seedance 2.0 Mini (video-seedance-2-mini-*) として解釈してください。Standard/fast は明示的に引き続き利用可能です。参照ビデオ/オーディオが必要な場合はこれらを使用してください。
• Seedance 2.5 には、意図的に分離された 4 つのシーンエンドポイントがあります。画像が存在するという理由だけで、あるシーンを別のシーンに変換しないでください。
  • video-seedance-2-5-text: プロンプトのみ。メディア入力はありません。
  • video-seedance-2-5-first-frame: ちょうど 1 つの --first-frame。出力はそのフレームから始まるため、これは機能のみの参照ではありません。
  • video-seedance-2-5-first-last-frame: ちょうど 1 つの --first-frame と 1 つの --last-frame。プロバイダーの契約により、比率は adaptive、duration は -1 に固定されます。
  • video-seedance-2-5-reference: 1 つ以上の繰り返し可能な --reference-image、--reference-video、または --reference-audio。これらは機能/スタイル/コンテンツを誘導するものであり、開始フレームや終了フレームではありません。
• 2.0 では、standard/fast の -text エンドポイントは画像/ビデオ/オーディオの参照を受け付けます。mini の -text は画像のみを受け付けます。すべての -image エンドポイントは 1 つの --image ファーストフレームを取り、参照スロットはありません。
• 公開されているエンドポイントキーとそのオプション enum (解像度、アスペクト比、duration の範囲) は postplus media schema --json から検出されます。ここにハードコードされているわけではありません。
• duration はエンドポイントの公開されている範囲内 (スキーマを参照) で設定してください。有効な値の間に入る編集ターゲットについては、最も近い有効な duration を選び、targetEditDurationSeconds を設定してください。
• targetEditDurationSeconds < duration の場合、timeline.activePerformanceEndSeconds と timeline.tailStrategy を含めてください。
• ターゲットスクリプトまたはビートプランがエンドポイントの最大 duration を超える場合は、独立した送信可能なセグメントに分割してください。1 つの過大なリクエストを送信しないでください。
• 2.5 の参照 edit または extend では、参照ビデオを指定し、正確なスキーマ制約 (aspect_ratio=adaptive、duration=-1) を使用してください。CLI と Web の境界は、プロバイダーへの送信と課金の前に、サポートされていない組み合わせを拒否します。

ソースとリクエスト

• メディア、スクリプト、再生時間、出力ルート、ソースの根拠、およびユーザーが提出を望んでいるのかコマンドのみを望んでいるのかを確定します。
• promptPlan.*、timeline.*、targetEditDurationSeconds はオーサリング用語であり、Seedance のリクエストフィールドではありません。postplus media schema --json から検出したフラットなプロバイダー契約に基づくエンドポイントの CLI フラグで提出してください（--prompt、レガシー 2.0 の --image、2.5 の --first-frame / --last-frame、--duration、--resolution、--aspect-ratio、--generate-audio、--output-format、--omni-reference-task-type、および繰り返し指定可能な --reference-image / --reference-video / --reference-audio — 参照フラグはそれらのスロットを公開しているエンドポイントでのみ使用可能です）。CLI は選択されたエンドポイントの契約外のフラグを拒否します。ストーリーライン／音声プラン、および timeline.activePerformanceEndSeconds / timeline.tailStrategy の指示を単一の --prompt ナラティブに構成し、その後サポートされているレンダーバケットを --duration にマッピングしてください。タイムラインのオーサリングフィールドには個別のフラグやリクエストフィールドはなく、オーサリングすべきリクエスト JSON エンベロープも存在しません。
• 参照は明示的にバインドしてください。[image 1]、[image 2]、[audio 1]、または [video 1] が何を制御するのかを記述します。最終リクエストで same as previous、content above、またはバインドされていないローカルハンドルに依存しないでください。
• ローカルの参照メディアは postplus media-file upload --skill seedance-submitter --input-file <file> --mime <mime> --output <upload.json> でホスト型ストレージにアップロードし、その後 output.mediaReference — 失効しない永続的な postplus-media:// 参照 — を Seedance のメディアフラグに渡してください（例えば --reference-image <output.mediaReference>）。ホスト型の境界がプロバイダー送信時にこれを新しい署名付き URL に交換するため、一度アップロードすれば以降の提出で同じ参照を再利用できます。output.data.download_url は失効する署名付き URL です。output.mediaReference を優先してください。
• PostPlus ホスト型ストレージ経由のアップロードが Moyu の実在人物免除を自動的に付与すると主張しないでください。自動 Moyu アセットライブラリのエスカレーションは、実際のエンドツーエンドのエビデンスを伴うエンタープライズ Seedance 2.0 の first_frame パスに対してのみ有効です。reference_image は asset:// 書き換え後の記録された実行でもプライバシーブロックされたままであり、有償の Seedance 2.5 免除スモークは承認されていません。どちらのパスもプロバイダーの型付きポリシー境界で失敗します。

レビューとハンドオフ

• 提出前に、バリデーションが通過したこと、すべてのセグメントが自己完結していること、参照がバインドされていること、必要なメディアが存在すること、ソースの根拠が明示されていること、出力パスが永続的であることを確認してください。
• Seedance 2.5 のサポートは、公式／ライブのプロバイダー資料およびローカルの submit/poll/result/billing モックによって契約検証済みです。承認された有償スモークが MP4、実際の再生時間、解像度、音声トラック、および決済を確認するまでは、それらの出力プロパティをアーティファクト実証済みとラベル付けしないでください。
• レンダーが保留中の場合、セグメント ID、マニフェストパス、output.data.id 生成ハンドル、ポーリングコマンド postplus media poll --handle <output.data.id>、および想定されるローカルの renders/ 出力パスを返してください。ポーリングコマンドはコマンド内で待機します（1 回の呼び出しにつき 8 秒ごとに最大 45 秒まで再チェックします。--wait-seconds 0 = 単一チェック）：レンダーが保留中の間は、再提出したりより短いリトライループを書いたりするのではなく、同じコマンドを再実行してください。
• 完了したレンダーは postplus media-file download --url <fresh-output-url> --output-file <renders/...>（またはホスト型ストレージにあるメディアには --reference <postplus-media://...>）でディスクに保存してください。プロバイダーの出力 URL は一時的なので、新しいうちにダウンロードしてください。

停止条件

• 必要なユーザーインテント、ソースのエビデンス、または所有する入力アーティファクトが欠けており、推測すると結果が変わる場合には停止してください。
• 所有する CLI またはスクリプトコマンドが失敗した場合、正確なエラーを報告して停止してください。メタデータのみの回答、レディネスプロービング、ローカルペイロードの書き換え、フォールバックプロバイダー、または未公開のツールで失敗を回避しないでください。

公開コマンドの境界

• ユーザー入力から最小の一致するコマンドまたはワークフローを選択し、直接実行します。
• レディネス診断: postplus doctor --skill seedance-submitter。
• 保留中のレンダリングをポーリングします: postplus media poll --handle <output.data.id>（呼び出しごとにコマンド内で最大45秒待機します。保留中は再実行してください）。
• postplus media schema --json は、未知のリクエスト形状を構築または修復する場合にのみ使用してください。
• 以下の生成されたコマンドでホスト型送信を実行します。プロバイダー API を直接呼び出さないでください。

postplus media create video-seedance-2-fast-image \
  --prompt <prompt> \
  --image <image> \
  --output <result.json>

• CLI が引用確認チャレンジを返した場合は、postplus quote confirm --json --challenge-file <challenge.json> を実行し、返されたトークンで再試行します。