OpenClaw で Ideogram V3 を使う。
Ideogram V3 は業界トップクラスのテキストレンダリングで画像を生成します — 他の画像モデルが苦手とする、ポスター、ロゴ、サインの読みやすいタイポグラフィを実現します。3つのエンドポイント（text_to_image、edit_image、remix_image）と、生成時間を半分に短縮しコストも抑える turbo 速度ティアを提供します。OpenClaw のエージェントは、チャットに使うのと同じ RunAPI キーと /v1 エンドポイントでこれを呼び出します。追加の skills のインストールは不要です。
RunAPI を使って Ideogram V3 で正確なテキストレンダリングを備えた画像を生成します。
要件：
- RunAPI の API https://runapi.ai/v1/text_to_image を使用する。
- RUNAPI_API_KEY 環境変数から API キーを読み込む。
- model を "ideogram-v3-text-to-image" に設定する。
- 画像内にレンダリングしたい具体的なテキストを含むプロンプトを書く。
- 任意で、生成を速くするには rendering_speed を turbo に、最良の結果には quality に設定する。
- レスポンスは task_id を返します。タスクが完了するまでタスクステータスのエンドポイントをポーリングし、出力 URL を取得する。
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v3-text-to-image",
"prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
"style": "design",
"aspect_ratio": "3:4",
"rendering_speed": "balanced"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "ideogram-v3-text-to-image"
}
OpenClaw で Ideogram V3 を使う3ステップ
Configure RunAPI
Set the RUNAPI_API_KEY environment variable in your shell profile. If RunAPI is already configured in OpenClaw for chat, the same key works for Ideogram V3 — no additional setup needed.
export RUNAPI_API_KEY=runapi_xxx
Call Ideogram V3
Send a POST request to the text_to_image endpoint with model set to ideogram-v3-text-to-image. Include your prompt with any text you want rendered in the image. Set style to design for poster and logo work, or realistic for photographic output. Use rendering_speed turbo for faster results at lower cost.
POST /v1/text_to_image
Get the result
The API returns a task_id immediately. Poll the task status endpoint until the status changes to completed, then retrieve the output image URL from the response. Request up to 4 images per call with output_count.
task_id: tsk_abc123
Ideogram V3 API パラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
model |
string |
Required. ideogram-v3-text-to-image, ideogram-v3-edit, or ideogram-v3-remix. |
prompt |
string |
Text description of the desired image. Include specific text you want rendered. |
style |
string |
Optional. auto, general, realistic, or design. Use design for posters and logos. |
rendering_speed |
string |
Optional. turbo (fastest, lowest cost), balanced (default), or quality (highest detail). |
aspect_ratio |
string |
Optional. 1:1, 3:4, 9:16, 4:3, or 16:9. |
output_count |
integer |
Optional. Number of images to generate per request. 1 to 4. |
source_image_url |
string |
Required for edit and remix endpoints. URL of the source image. |
OpenClaw上のIdeogram V3とは？
Ideogram V3は生成画像のタイポグラフィで「ゲームチェンジャー」と呼ばれるモデルです——1〜2回の試行で90〜95%のテキスト精度を達成し、スタイル参照でブランドの一貫性を維持することをサポートします。OpenClaw agentはチャットと同じRunAPIキーを使って呼び出します。
Ideogram V3の活用例
広告・マーケティングビジュアルのタイポグラフィ
クリーンで読みやすいテキスト付きのSNS広告・バナー・プロモーション素材を生成し、何度もリトライすることなく初回の生成から使えます。
ブランドビジュアルとロゴデザイン
正確なテキストレンダリングと一貫したビジュアルスタイルでブランド素材を作成します。スタイル参照を使って生成したすべての素材でブランドアイデンティティを維持します。
ECプロダクト展示画像
商品名・価格・機能テキストを表示した商品画像を生成し、テキストが画像に正確に埋め込まれ、後からテキストオーバーレイを追加することなくリストページに直接使用できます。
Ideogram V3 + OpenClaw のよくある質問
Ideogram V3 is specifically optimized for typography rendering. It can produce readable multi-line text, stylized headings, and logo-quality lettering that models like Flux or Imagen often garble. If your use case requires accurate text on posters, signs, or product labels, Ideogram V3 is the strongest option in the RunAPI catalog.
Turbo generates the fastest at roughly half the cost of balanced. Quality produces the highest-detail output but takes longer. Balanced is the default middle ground. All three tiers use the same underlying Ideogram V3 model — the difference is compute time and fidelity, not model version.
Yes. Use the edit_image endpoint with ideogram-v3-edit to modify a source image guided by a text prompt. Use the remix_image endpoint with ideogram-v3-remix to transfer the style of a source image to a new composition. Both require source_image_url as a parameter.
Each generated image is billed separately. If you set output_count to 4, you are charged for 4 images. The per-image rate depends on your rendering_speed setting — turbo costs roughly half of balanced. Check the RunAPI pricing page for current rates.
Async. The API returns a task_id immediately. Poll the task status endpoint until the task completes. RunAPI SDKs and the CLI handle polling automatically. Failed generations are not charged.
今すぐ OpenClaw で Ideogram V3 を試す。
無料の RunAPI キーを取得し、プロンプトを OpenClaw に貼り付ければ、Ideogram V3 で正確なタイポグラフィを備えた画像を生成し始められます。