mcpField

happy-dreamina

github.com/iamzhihuixクリエイティブ・メディア161 回インストール
リポジトリ

happy-dreamina について

ByteDance公式の`dreamina` CLIで画像や動画を生成・取得するためのスキルです。ログイン確認、コマンドやパラメーターの選択、非同期結果の取得、タスク履歴の確認を案内します。

主な機能

  1. 01テキストからの画像生成と画像変換
  2. 02テキスト・画像からの動画生成
  3. 03ログインとクレジットの事前確認
  4. 04アスペクト比と解像度の選択
  5. 05タスク履歴と非同期結果の取得

活用シーン

  1. 01テキストプロンプトから画像を生成
  2. 02既存画像の変換やスタイル変更
  3. 03テキストやキーフレームから動画を作成
  4. 04Dreaminaのタスクやクレジットを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-dreamina

インストール後、Claude Code で/happy-dreaminaを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cli-commands.md
install-and-login.md
ratio-resolution-map.md
troubleshooting.md

詳細

happy-dreamina

ByteDance の公式 dreamina CLI を通じて、画像や動画を生成します。このスキルは薄い指示レイヤーであり、SDK をラップするものではありません。すべての操作は、ユーザーのシェルにすでにインストールされている dreamina のサブコマンドに対応しています。

このスキルを呼び出すタイミング

次のいずれかに該当する場合は、このスキルを使用してください。

  • ユーザーが 即梦、Jimeng、または Dreamina と言った場合（言語は問いません）。
  • ユーザーが dreamina CLI またはそのサブコマンドを明示的に指定した場合。
  • ユーザーが Jimeng のタスク履歴、アカウントのクレジット、またはログイン状態について尋ねた場合。

ユーザーが「画像を生成して」や「画张图」とだけ言い、Jimeng を指定していない場合は、代わりに happy-image-gen ／ happy-video-gen を優先し、このスキルは呼び出さないでください。Jimeng はブラウザーでログインする特定のプロバイダーであるためです。他のスキルでは、EXTEND.md のデフォルト設定を通じて、多数のプロバイダーからユーザーが選択できます。

ステップ 0：事前確認（必須 — ほかの操作の前に両方のチェックを実行）

次のチェックを並行して実行してください。

  1. command -v dreamina — バイナリがインストールされているか確認します。
  2. dreamina user_credit — ログインが有効か確認します。正常な応答は、クレジット情報を含む JSON です。
dreamina がインストールされていない場合

dreamina CLI が見つからないことをユーザーに伝え、インストールを提案してください。公式インストーラーは次のとおりです。

curl -fsSL https://jimeng.jianying.com/cli | bash

これはユーザーのマシンに書き込みを行うシェルインストールです。黙って実行してはいけません。確認を取り、実行した後、command -v dreamina を再確認してください。プラットフォームに関する注意事項（macOS、Linux x86_64/arm64）については、references/install-and-login.md を参照してください。それ以外のプラットフォーム（例：Windows）の場合やインストーラーが変更された場合は、公式インストールページを案内してください：https://jimeng.jianying.com/ai-tool/install。

user_credit が失敗した場合（終了コードが 0 以外、または JSON にクレジット情報がない場合）

ユーザーがログインしていないか、トークンの有効期限が切れています。次のコマンドを実行するよう依頼してください。

dreamina login

これにより、Jimeng の認証用にデフォルトのブラウザーが開きます。認証情報は ~/.dreamina_cli/credential.json に自動的に保存されるため、ユーザーがファイルを扱う必要はありません。ブラウザーが開かない場合や処理が止まった場合は、dreamina login --debug を案内してください（references/troubleshooting.md を参照）。

dreamina user_credit が成功するまで、生成に進んではいけません。

ステップ 1：適切なサブコマンドを選択

ユーザーの意図を、次のいずれか 1 つのサブコマンドに対応させてください。

ユーザーの希望コマンド
テキストから画像を生成するdreamina text2image
既存の画像を変換またはスタイル変更するdreamina image2image
テキストから動画を生成するdreamina text2video
静止画像をアニメーション化する（i2v）dreamina image2video
以前の非同期処理の結果を取得するdreamina query_result
過去のジョブを閲覧するdreamina list_task

ステップ 2：ユーザーの意図からパラメーターを設定

references/ratio-resolution-map.md を使って、自然言語（「竖屏 ／ 1080P ／ 高清 ／ 方图 ／ 横屏」）をフラグに変換してください。ユーザーが指定していないことにも注意し、安全なデフォルト値を設定してください。明らかなことをユーザーに言い直すよう求める必要はありません。

画像生成 — text2image ／ image2image
  • --prompt="..." — シェルのメタ文字（中国語の引用符、コンマなど）で問題が起きないよう、必ず二重引用符で囲んでください。
  • --ratio — 1:1 / 16:9 / 9:16 / 3:4 / 4:3。デフォルトは 1:1。
  • --resolution_type — 1k / 2k / 4k。デフォルトは 2k。高速な下書きには 1k、ユーザーが超高解像度または印刷向けを求めた場合に限り 4k を使用してください。
  • image2image のみ：--images <path>（複数形 — 参照画像のセットを受け付けます。複数のパスはスペースで区切ります）。
  • 必ず --poll=30 を含めてください。
動画生成 — text2video ／ image2video
  • --prompt="..." — 引用符のルールは同じです。
  • --duration — 整数の秒数。デフォルトは 5。
  • --ratio — 横長の場合のデフォルトは 16:9、縦長は 9:16、正方形は 1:1。
  • --video_resolution — 480P / 720P / 1080P。デフォルトは 720P。
  • image2video のみ：--image <path>（単数形 — キーフレームを 1 枚指定します）。
  • 必ず --poll=60 を含めてください（動画は画像より時間がかかります）。

⚠ 間違えやすい点：image2image は --images（複数形、参照画像のセット）を使用します。image2video は --image（単数形、キーフレーム 1 枚）を使用します。取り違えると「unknown flag」エラーが発生します。

ステップ 3：結果を送信して読み取る

Bash 経由でコマンドを実行します。成功すると、CLI は JSON を標準出力に表示します。内容は結果の URL、または --download_dir を指定した場合はローカルファイルのパスです。パスまたは URL をユーザーに伝えてください。

例 — テキストから画像を生成：

dreamina text2image \
  --prompt="一只戴墨镜的橘猫,背光,电影感" \
  --ratio=1:1 \
  --resolution_type=2k \
  --poll=30

例 — 画像から動画を生成：

dreamina image2video \
  --image=./keyframe.png \
  --prompt="镜头缓缓推近,橘猫眼神闪动" \
  --duration=5 \
  --ratio=16:9 \
  --video_resolution=720P \
  --poll=60

ユーザーが URL ではなく結果をローカルにダウンロードしたい場合は、--download_dir=./out を追加します（先にディレクトリを作成してください）。

ステップ 4：非同期処理のタイムアウトに対応する

--poll がタイムアウトした場合、CLI はステータスが querying で submit_id を含む JSON を返します。再試行することをユーザーに伝えてから、次のコマンドを実行します。

dreamina query_result --submit_id=<submit_id> --download_dir=./out

ジョブがまだ進行中の場合は、待機して再試行します。失敗した場合は、query_result のレスポンスからエラーメッセージを取得し、そのまま伝えてください。推測してはいけません。

詳細：履歴とセッション

  • dreamina list_task --gen_status=success — 完了したジョブを一覧表示します。
  • dreamina list_task --submit_id=<id> — 特定のジョブを取得します。
  • セッション（v1.3.5 以降）を使うと、プロジェクトごとに別々のワークスペースを維持できます。ユーザーが「セッションを切り替える」「セッション X で作業する」「セッションを一覧表示する」と明示的に求めた場合にのみ、セッションを操作してください。それ以外の場合は、デフォルトのセッションで問題ありません。

参考資料

必要に応じて読み込んでください。最初にすべて読む必要はありません。

  • references/cli-commands.md — すべての dreamina サブコマンドのフラグ一覧。
  • references/install-and-login.md — インストーラーの詳細、ブラウザーでのログイン、認証情報ファイルの場所、バージョンアップグレード。
  • references/ratio-resolution-map.md — ユーザーの表現と --ratio／--resolution_type／--video_resolution の対応関係。
  • references/troubleshooting.md — ログインの期限切れ、キューのタイムアウト、submit_id の復旧、アカウントの切り替え。

コメント

Markdown 対応