text-to-visual について
text-to-visualは、Picsartのgen-ai CLIで段落、記事、URLに合う画像を作成するスキルです。単一画像、記事セット、OG画像の3つのモードでコンテンツ制作を支援します。
主な機能
- 01段落、記事、URLを入力
- 02単一画像、記事セット、OGの各モード
- 03テーマ、トーン、配色の手掛かりを抽出
- 04複数画像の生成前に料金を見積もり
- 05生成画像とサイズを検査
活用シーン
- 01記事のヒーロー画像と本文画像を作成
- 02URL用のOG画像やソーシャルカードを作成
- 03段落に添える画像を1枚生成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/text-to-visualを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/modes/article-set.mdog.mdsingle.md詳細
テキストからビジュアルへ
Picsart の gen-ai CLI が対応する「テキストをもとに、それに合った画像を生成する」すべてのワークフローをカバーする単一のスキルです。段落、ブログの下書き、URL など、どのような文章でも、そこからビジュアルを生成したい場合に使用します。より限定的な3つのスキルを、ひとつのエントリーポイントと3つのモード別リファレンスに統合します。
**入力：**テキスト（段落、記事、URL）。**出力：**テキストのトーン、トピック、掲載先に合った画像1枚以上。
使用するタイミング
| モード | 該当する依頼の例 | リファレンス |
|---|---|---|
| single | 「この段落に合うビジュアルを選んで」「このセクション用のインライン画像」「このコンテンツ用のビジュアルを1つ」 | references/modes/single.md |
| article-set | 「このブログ記事にイラストを付けて」「記事用のヒーロー画像とインラインビジュアル」「下書き用のビジュアル一式」 | references/modes/article-set.md |
| og | 「この URL 用の OG 画像」「Open Graph プレビュー」「Twitter カード画像」「動的メタ画像」 | references/modes/og.md |
商品の写真を加工したい場合は、product-photo-studio を使用します。動画を作りたい場合は、gen-ai-use を使用します。
前提条件
Picsart gen-ai CLI がインストールされ、認証済みであること：
curl -fsSL https://picsart.com/gen-ai-cli/install.sh | bash
gen-ai login
gen-ai whoami
キャッシュ、サーバーレスエンドポイント、フォントの選択など、モードごとの設定は各モードのリファレンスに記載されています。
実行方法
- 使用するタイミングの表を使って、ユーザーの依頼からモードを特定します。
- 該当するモードのリファレンスを読み込みます：
Readreferences/modes/<mode>.md。 - そこに記載されている手順に従い、テキストの特徴を抽出し、プロンプトを作成して生成します。
- タスクの途中でモードを切り替える場合のみ、この SKILL.md に戻ります。
クイックリファレンス
# Single image from a prompt
gen-ai generate --model <model> --prompt "<derived from text>"
# Estimate cost first
gen-ai pricing --model <model> --count <N>
# Browse available models
gen-ai models
段落、記事、URL のメタデータからプロンプトを導き出す方法など、プロンプト作成のパターンは各モードのリファレンスに記載されています。
手順
共通の基本ワークフロー：
- 特徴を抽出する — 入力テキストから主題、トーン、配色のヒント、目標寸法を取り出します。
- プロンプトを作成する — 特徴を
gen-aiプロンプトに反映します。各モードには専用のテンプレートがあります。 - 見積もる — 複数画像を生成する場合は、実行を確定する前に
gen-ai pricingを実行します。 - 生成する —
gen-ai generateを実行します。進捗をストリーミングします。 - 配置する — PDP、ブログのフロントマター、OG メタタグ、SNS 向けのバリエーションなど、適切な場所に配置します。
注意点
- 元のテキストをそのまま使って生成しないでください。 先に必ず特徴を抽出してください。段落をそのまま使うと、文字どおりで生気のない画像になります。
- 掲載先に合ったアスペクト比にしてください。 OG = 1200×630、ブログのヒーロー画像 = 16:9、SNS = さまざまです。
- OG 画像をキャッシュしてください。 ページを表示するたびに再生成しないでください。
references/modes/og.mdを参照してください。 - モード固有の注意点は各モードのリファレンスに記載されています。
検証
# Confirm output exists and matches expected dimensions
gen-ai inspect outputs/<run>/<image>.png
# Spot-check the visual matches the source text by re-reading both side by side
関連項目
product-photo-studio— 既存の商品写真を加工しますgen-ai-use— gen-ai CLI の基本リファレンス
コメント
Markdown 対応