dreamina-cli

Dreamina CLI

⚠️ メンテナンス終了のお知らせ：旧版 Dreamina CLI（dreamina、v1.4.18）は、2026 年 11 月をもってメンテナンスを終了します。新しいタスクには、代替スキルの Canvas dreamina-canvas-cli をご利用ください（インストール：npx skills add full-aigc-skills/dreamina-skills --skill dreamina-canvas-cli）。このスキルの内容は、過去の仕様の参照用として保管されています。

dreamina を通じて Dreamina（即梦）の画像または動画を生成したり、ログイン、セッション管理、タスク履歴の操作を行ったりする場合は、このスキルを使用してください。

即梦は Dreamina の中国語製品名です。一般的な即梦に関するリクエストには dreamina-canvas-cli を選択し、明示的に旧版 CLI の使用を求められた場合にのみ、この凍結されたスキルを使用してください。

このスキルは意図的に簡潔にしています。詳細なフラグとサポートされる値は CLI 自体で確認できるため、常に dreamina -h と dreamina <subcommand> -h を一次情報として扱ってください。

参照資料は必要に応じて段階的に確認してください。

• インストール、認証、アカウント確認、公開されているすべてのコマンドファミリー、セッションの CRUD、更新、ログのトラブルシューティングについては、 references/official-cli-install-to-use.md をお読みください。
• v1.4.18 のモデル、解像度、時間、アスペクト比の制約については、 references/dreamina-cli-v1.4.18-contract.md をお読みください。

使用場面と適用範囲

初回インストールからトラブルシューティングまで、またはログイン、セッション、タスク履歴、非同期タスクのフォローアップ、コマンドの振り分けが複数のモダリティにまたがる場合は、この包括的なスキルを使用してください。4 つの実行スキルにおけるモード固有のワークフローや、プロンプトのみの作成の代わりとして使用しないでください。

このツールの用途

dreamina は、現在公開されている Dreamina（即梦）の画像・動画生成ワークフローすべてと、それに関連するアカウントおよびセッション操作のためのローカル CLI エントリーポイントです。

次の用途に使用します。

• 既存の Dreamina ログインセッションを確認、または再利用する
• アカウントのクレジットを確認する
• dreamina session でセッションを管理する
• dreamina logout でローカルの OAuth ログイン状態をクリアする
• 画像生成タスクを送信する
• 動画生成タスクを送信する
• 非同期タスクの結果を照会し、生成メディアをダウンロードする
• 保存済みのタスク履歴を確認する

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

この CLI をエージェントとして使用する場合：

Step 1：環境を確認する

dreamina が見つからない場合は、インストールから利用までの参照資料を読み、ソフトウェアをインストールまたは更新する前に明示的な許可を得てください。それ以外の場合は、まず dreamina version と dreamina -h を実行し、実際に使用する前に dreamina <subcommand> -h を実行してください。

Step 2：認証して振り分ける

ユーザーからログイン状態の変更を求められない限り、既存のログインを再利用してください。ログイン後の準備状況の確認には user_credit を使用してください。生成タスクは、対応する実行スキルに振り分けてください。

Step 3：タスクを送信し、終端状態まで追跡する

クレジットが消費されることを警告し、ヘルプの確認と実際の送信を区別したうえで、受け付けられたすべてのタスクを success または fail になるまで追跡してください。

検証

• モデルまたは解像度に関する前提を変更する前に、インストール済み CLI のヘルプを確認済みの仕様と照合してください。
• dreamina <subcommand> --help を実行して、動画のアスペクト比サポートを実行時に確認してください。4 つの動画コマンドは --ratio を公開していますが、multiframe2video は最初の画像からアスペクト比を推定します。
• アップロード前にローカルファイルを検証し、返された submit_id をすべて保持してください。
• 終端状態はシェルの終了コードだけで判断せず、query_result で検証してください。

注意事項

1. ヘルプの変化：リリースノートは、現在のサブコマンドのヘルプの代わりにはなりません。
2. 情報源の重複：パラメーターの一覧は v1.4.18 の仕様参照にまとめてください。
3. 受け付けられた状態と成功の違い：querying は終端の成功状態ではありません。
4. 有料の操作：実際に生成タスクを送信する前に警告してください。
5. OAuth の中断：ログインに成功したか、既存のログインを再利用したか、失敗したかを必ず報告してください。
6. トラブルシューティングの順序：正確なコマンド、エラー、dreamina version、および関連する ~/.dreamina_cli/logs/ の抜粋を記録してください。秘密情報を削除し、許可を得てから CLI を更新し、同じコマンドを一度だけ再試行してください。

ログイン完了：ユーザーに必ず確認を伝える

dreamina login / dreamina relogin は OAuth Device Flow の手順を表示した後、認証を待機します。コマンドが正常に終了したら、ログインに成功したこと、またはローカルの OAuth 状態が再利用されたことを、ユーザーにはっきり伝えてください。

• ユーザーが「ログインできましたか」と尋ねるまで待たないでください。
• **デバイスコードを送るだけで終わらせないでください。**ログインコマンドを実行し続け、stdout を最後まで読み取ってから、成功／再利用／失敗を確認してください。
• 失敗した場合も、具体的なエラーと次の手順を必ず報告してください。

適切なコマンドの選び方

概要は以下のとおりです。

• 予算の確認には user_credit を使います。
• セッションの作成、一覧表示、検索、名前変更、削除には session を使います。すべての生成コマンドは --session=<id> を受け付け、デフォルトのセッションは 0 です。
• submit_id をすでに取得している場合は query_result を使います。生成したメディアをローカルに保存する場合は --download_dir を追加します。
• 最近保存したタスクを確認する場合、特にステータスやタスクの種類で絞り込む場合は list_task を使います。
• プロンプトのみで画像を生成する場合は text2image、画像を使って編集する場合は image2image、アップスケールする場合は image_upscale を使います。
• プロンプトのみで動画を生成する場合は text2video を使います。
• メイン画像が1枚で十分な場合は image2video を使います。ユーザーが一貫したストーリーのために複数の画像を用意している場合は、multiframe2video を優先します。
• 最初と最後のフレームを基準に動画を生成する場合は frames2video を使います。
• Dreamina のインテリジェントなマルチフレーム処理には multiframe2video を使います。複数の画像を入力し、一貫したストーリーの動画を1本生成します。
• 画像、動画、音声を横断する参考素材が必要なタスクで、Dreamina のフラッグシップ動画モードを使う場合は multimodal2video を使います。seedance2.0 ファミリーに対応しています。旧名称の ref2video が表示される場合は、現在のコマンド一覧を dreamina -h で確認してください。

正確なフラグと対応する組み合わせは、各サブコマンドの -h を参照してください。

モデル選択のルール

このスキルに基づいて、対応モデルを固定しないでください。

ユーザーがモデルを指定した場合は、実行前に必ず該当するサブコマンドのヘルプを確認してください。

dreamina <subcommand> -h

サブコマンドのヘルプで、以下を確認してください。

• そのコマンドにモデル選択機能があるかどうか
• 指定されたモデルがそのコマンドでサポートされているかどうか
• そのモデルに適用されるその他の制約（長さ、比率、解像度、そのコマンドが model_version に対応しているかどうかなど）

補足：

• モデル選択機能がないコマンドもあります。
• 一部のモデル、特に seedance2.0 ファミリーは、利用容量に制約がある場合があります。
• 最高品質より速度を優先するユーザーには、明示的に希望されない限り、デフォルトで seedance2.0 を選ばないでください。

送信の受理と最終的な成功の判断方法

シェルの終了コードだけに頼らないでください。

非同期生成コマンドでは、submit_id があり、gen_status=querying であることが示すのは、送信が受理されたということだけです。生成が最終的に成功したと判断できるのは、gen_status=success の場合に限ります。gen_status=fail の場合は fail_reason を確認し、先回りして回答してください。

非同期タスクのフォローアップ手順

送信後に querying が返された場合：

1. submit_id を保存します。
2. フォローアップには query_result --submit_id=<id> を使います。
3. 保存済みタスクをまとめて確認する場合は list_task を使います。
4. タスクが success または fail になるまで確認を続けます。

テストを一括実行する場合は、後から返された submit_id の値を照会できるよう、機械可読な形式で結果を保存してください。

ユーザー向けの重要なルール

• 一部の生成コマンドは非同期です。送信と照会は別の手順です。
• 一部のモデルでは、Dreamina Web で一度だけ認証が必要になる場合があります。 CLI が AigcComplianceConfirmationRequired を返した場合は、先に Web 側で確認を完了してから再試行するよう、積極的に案内してください。
• コマンドごとに、対応するモデル、比率、時間、解像度が同じだと想定しないでください。 使用前に各サブコマンドの -h を確認してください。
• v1.4.18 では、text2video と multimodal2video は明示的な --ratio を受け付けます。image2video と frames2video はフラグを公開していますが、seedance2.5 では拒否されます。multiframe2video には比率フラグがありません。コマンド間でルールを一般化せず、実行時にこれらのルールを再確認してください。

エージェントの望ましい振る舞い

• ユーザーがログインを完了できるよう、OAuth Device Flow の手順を正確に伝えてください。
• ログインコマンドが完了したら、必ずユーザーに見える確認メッセージで一連の流れを完了させてください。
• 実際の生成タスクを実行する場合は、確認しやすい小さなバッチを優先してください。
• 実行した有料テストごとに、コマンド、引数、submit_id、最終ステータスを記録してください。
• ユーザーが生成速度を重視している場合、明示的に求められているか、出力品質を明らかに優先していない限り、seedance2.0 ファミリーをデフォルトにしないでください。
• レポートを作成する場合は、以下を分けてください。
  • ヘルプのみの確認
  • 送信段階の検証
  • 後続の非同期結果確認

使用する場面（何に使うか）

ユーザーが 現在のリクエストに対して、検証可能かつ復旧可能な専門ワークフローを選択して実行する必要がある ときに、このスキルを読み込みます。リクエストから目的、入力、制約、納品形式、受け入れ基準を抽出します。説明の要約：エージェントがアカウント、セッション、画像、動画、タスク照会、ダウンロードの各ワークフローで Dreamina（即梦）CLI をインストール、更新、認証、トラブルシューティング、操作する必要があるときに使用します。

ルール

• 読んでから書く：外部状態を変更する操作を行う前に、現在の状態と実際の機能を確認します。
• 最小権限：現在の手順に必要なファイル、ツール、アカウント、ネットワーク範囲のみを使用します。
• 証拠を優先：実行結果、リソース ID、バージョン、ハッシュ、テスト出力が欠けている場合は、NOT_VERIFIED と明記します。
• 冪等性を優先：リクエスト ID と各段階の状態を保持します。結果が不明な場合は、やみくもに再試行せず、まず照会します。
• プライバシーと安全性：ログ、例、受領記録、エラーメッセージにトークン、Cookie、秘密鍵、個人の機微情報を含めてはいけません。

ワークフロー

Step 1：意図を明確にする

このスキルが目的に合っているか確認します。近接する別の要件であれば、より適切なスキルに引き継ぎます。

Step 2：事前確認を行う

目的、入力、制約、利用可能なツール、成功基準、失敗時の境界を確認します。重要な条件が不明な場合は、読み取り専用の段階で停止します。

Step 3：計画を立てる

呼び出すツール、変更する対象、成功基準、失敗時に安全に終了する方法を列挙します。

Step 4：操作を実行する

必要最小限の手順で実行し、重要な状態変化の箇所で証拠を記録します。外部呼び出しごとに、関連付け可能な状態または受領記録を保持します。

Step 5：納品内容を検証する

結果、検証証拠、未完了項目、リスク、明確な次の手順を提示します。事実、推論、未検証項目を分けて記述します。

検証チェックリスト

• スキルの適用条件とユーザーの意図が一致しており、近接するタスクを誤ってこのスキルに振り分けていない。
• 入力、対象、バージョン、出力先がすべて明確であり、必須値の代わりに推測値を使用していない。
• 書き込み、有料、公開、取り消し不能なすべての操作が、ユーザーの承認範囲内にある。
• 結果を独立した確認方法で検証している。「コマンドが成功した」または「ファイルが存在する」だけでは完全な受け入れとはみなさない。
• 出力に実際の証拠、失敗／スキップ項目、残存リスク、実行可能な次の手順が含まれている。

注意点

1. 計画を結果とみなすこと：ドキュメントやプロンプトは実際の実行を意味しません。実際に実行された段階を明記してください。
2. 誤った再試行：タイムアウトや応答の消失が発生しても、リモート側の状態はすでに作成されている可能性があります。再試行するかどうかを決める前に、まず照会してください。
3. 暗黙の範囲拡大：一括処理、全件処理、公開、上書き、有料操作は、通常の読み取り／書き込みの自然な延長ではありません。
4. バージョンのずれ：外部リソースを参照する場合は、バージョン、タグ、コミットを記録してください。変更されるブランチをリリースの証拠として扱わないでください。
5. 証拠の期限切れ：キャッシュ、古いスクリーンショット、過去のテストは現在の環境を証明できません。納品前に重要な証拠を更新してください。

対象外と境界

ユーザーが指定した範囲を超えてはいけません。書き込み、有料、公開、取り消し不能な操作には明確な承認が必要です。別のスキルが必要なリクエストの場合、その本文を複製せず、スキル名を使って引き継ぎ、現在のタスクのコンテキストを保持してください。

段階的な情報開示

• 入力／出力、状態、承認ポイントを確認する場合は、references/workflow-contract.md を読みます。
• 納品前の自己確認が必要な場合は、references/validation-checklist.md を読みます。
• タイムアウト、一部成功、復旧の状況では、references/error-recovery.md を読みます。
• 初回実行、権限超過の拒否、失敗からの復旧については、それぞれ examples/happy-path.md、examples/boundary-refusal.md、examples/failure-recovery.md を参照します。