API リファレンス

この API とは

MyDreamVid API を使うと、誰もスタジオを操作することなく、あなたのソフトウェアが Seedance / Seedream モデルで動画と画像を生成できます。プログラムがプロンプト（と任意のリファレンスファイル）を送信すると、ウェブスタジオと同じ安全チェックと同じ価格設定を適用し、プログラムが完成ファイルを受け取ります。クレジットは同じアカウント残高から消費されます。

誰のためのものか

• 大量に生成するチーム：商品カタログ、広告バリエーション、SNS クリップ、1本の動画のローカライズ版。
• 自分のアプリ、ツール、ボット、社内パイプラインに動画・画像生成を組み込む開発者。
• 自前のフロントエンドを持ちたい代理店やスタジオ — モデル、キュー、課金は当社が担います。

週に数本を手作業で作るだけなら、API は不要です。スタジオは API と同じことを同じ価格でこなします。

認証

すべてのリクエストにベアラーキーを付けます。キーはスタジオで作成され、表示されるのは一度だけです。

• Header: Authorization: Bearer mdv_live_…
• 権限 write はタスクの作成・キャンセルとファイルのアップロードが可能。read は一覧と取得のみ。
• キーは Creator（$25）または Studio（$50）のチャージ後に利用可能。クレジットは無期限です。
• API はサーバーから呼び出すことを想定しています。ブラウザやモバイルのコードにキーを埋め込まないでください。

まず価格を知る

すべてのタスクにはクレジットがかかります（1クレジット = $0.01）。作成前に見積を取ってください。見積は無料で、Idempotency-Key も不要、タスクが予約する正確な額を返します。同じ数字がタスク作成時の credits_reserved として返り、完了したタスクの credits_charged が実際の支払額です（予約の未使用分は返還されます）。

GET /v1/credits でいつでも利用可能残高と予約残高を確認できます。API 経由で作成したタスクも、スタジオの「マイ作品」とクレジット履歴に表示されます。

エンドポイント

• GET /v1/models — 各モデルの長さ、解像度、比率、秒あたりクレジット価格、リファレンス上限。
• POST /v1/videos/quote — タスクの正確なクレジットコスト。無料、予約なし。
• POST /v1/videos — タスクを作成。Body: kind (t2v | i2v | r2v)、model、prompt、duration_s、resolution、ratio、任意で generate_audio、references。Idempotency-Key が必須。
• GET /v1/videos/{id} — タスクのステータス。succeeded のタスクには video_url が含まれます。
• GET /v1/videos — あなたのタスク一覧、新しい順、カーソルページネーション（limit、cursor）。
• POST /v1/videos/{id}/cancel — waiting または queued のタスクをキャンセル。
• POST /v1/files/presign — リファレンス用の画像・動画・音声ファイルのアップロード枠。
• POST /v1/files/{media_id}/confirm — アップロードを完了。ファイルは検査と安全チェックを経て、リファレンスとして使用可能になります。
• GET /v1/credits — 利用可能クレジットと予約中クレジット。

制限

• キーごとに毎分60リクエスト。
• API 経由の進行中タスク（waiting、queued、running）はアカウントあたり2件。
• モデルごとのレーンは全員で共有されます。レーンが満杯のときはタスクが順番待ちになり、自動的に送信されます。
• 有効なキーはアカウントあたり最大5個。
• ファイル：画像は最大 10 MB、動画は最大 50 MB、音声は最大 20 MB。リファレンス動画は2秒以上必須。動画と音声はいずれも最長5分です。