dreamina-cli

Dreamina CLI

Dreamina の画像または動画の生成、タスクの照会や一覧表示、クレジットの確認、セッション管理が必要な場合は、このスキルを使用してください。

即梦は Dreamina の中国語製品名です。ユーザーが即梦と言った場合は Dreamina として扱い、このスキルを使用してください。

dreamina を直接呼び出すより、scripts/ にあるパッケージ済みの Python ラッパースクリプトを優先してください。ラッパーはパスの検証、コマンドの正規化、構造化 JSON 出力、--dry-run、一貫したエラー処理を追加します。

特定のフラグやサポートされる値が不明な場合は、dreamina -h と dreamina <subcommand> -h を最終的な情報源としてください。

デフォルトのワークフロー

1. 機能を確認する必要がある場合は、python3 ./scripts/list_capabilities.py --format json を実行します。
2. ユーザーの依頼に最も適したラッパースクリプトを選びます。
3. コストが高い、または内容が曖昧な依頼の場合は、まずラッパーに --dry-run を指定して実行し、正確な CLI 引数を確認します。
4. 実際のラッパーコマンドを実行します。
5. シェルの終了コードだけに頼らず、ラッパーの JSON 応答を確認します。
6. 非同期生成の場合は、返された submit_id を保持し、ユーザーが後続のポーリングを希望する場合は query_result.py を使用します。

スクリプトの選択

• 画像生成：
  • text2image.py
  • image2image.py
  • image_upscale.py
• 動画生成：
  • text2video.py
  • image2video.py
  • frames2video.py
  • multiframe2video.py
  • multimodal2video.py
• タスクとアカウントの操作：
  • query_result.py
  • list_task.py
  • user_credit.py
• セッション操作：
  • login.py
  • login_checklogin.py
  • logout.py
  • relogin.py
  • session.py
• 機能の確認：
  • list_capabilities.py
• CLI バージョンの確認：
  • version.py

出力仕様

すべてのラッパーは、次の内容を含む JSON を返します。

• ok：ブール値
• command：ラッパーのコマンド名
• cli_args：展開済みのコマンド配列
• data：成功時の解析済み CLI ペイロード
• error および details：失敗時の正規化されたペイロード

生成ラッパーでは、次の条件を満たす場合にのみ、送信を有効として扱ってください。

• submit_id が存在する
• gen_status が querying または success である

生成ラッパーが gen_status=fail を返した場合、ラッパーはこれを ok: false に変換します。

安全上のルール

• ユーザーが明示的にログイン、ログアウト、または再ログインを依頼しない限り、現在のログインセッションを再利用してください。
• ログインまたは再ログインを実行する必要がある場合は、OAuth Device Flow の認証情報を表示するため、--headless フラグの使用を優先してください（例：python3 scripts/login.py --headless）。ユーザーがブラウザーで認証した後、python3 scripts/login_checklogin.py --device-code <device_code> --poll 30 を使用してください。
• モデルによっては、Dreamina Web での初回確認が必要な場合があります。CLI が AigcComplianceConfirmationRequired を報告した場合は、Web 側で認証を完了してから再試行するようユーザーに伝えてください。
• Seedream 5.0 Pro は現在、CLI では text2image と image2image の --model_version=5.0Pro として公開されています。
• 5.0Pro がサポートする resolution_type の値は 1k、2k、4k です。画像生成では、デフォルトのモデルは 5.0 であり、5.0Pro ではありません。
• 画像生成／アップスケールには resolution_type が必須で、すべての動画生成コマンドには video_resolution が必須です。
• text2image と image2image は、--width と --height の併用をサポートしています。カスタム寸法は --ratio と併用できません。
• 画像生成ラッパーは、CLI の generate_num を 1-10 の範囲で指定するための --generate-num／--generate_num をサポートしています。
• 現在の CLI ヘルプでは、seedance2.0mini はサポートされる Seedance 2.0 動画モデルです。今後 dreamina <subcommand> -h の出力で変更が示されない限り、生成時間は 4～15 秒、解像度は 720p のみとして扱ってください。
• seedance2.5 は 480p／720p と、4～30 秒の出力をサポートしています。マルチモーダルモードは音声のみの入力を受け付け、モデル固有のより高い入力制限を使用します。
• 小規模で確認しやすい生成バッチを優先してください。
• すべての非同期タスクの submit_id を記録してください。
• サポートされるコマンドでは、ユーザーが raw CLI の実行を明示的に依頼しない限り、ラッパースクリプトを介さずに実行しないでください。

参考資料

• ラッパーの一覧、パラメーター、使用例については、references/commands.md をお読みください。
• Vibe Coding IDE の使用方法や、OpenClaw または DeerFlow スタイルのエージェントランタイムに関する移植性のガイダンスについては、references/integration.md をお読みください。