使用ガイド
qwen-image-3.0-pro/text-to-image プロンプトレシピ：そのままコピー＆ペーストできるプロンプトと実際の出力
アプリアイコン、商品写真、バナー、壁紙、風景、ポートレートを網羅する6つの実プロンプト、実設定、実出力。
ほとんどの「プロンプトガイド」記事は、ひと言のアイデアとサムネイル画像を1枚くれるだけです。本記事では、qwen-image-3.0-pro/text-to-image 上で6つの異なるユースケースに対して私たちが実際に使用した完全なプロンプト原文、正確な API パラメータ、実際の1枚あたりのコスト、そして実際の出力画像を掲載します——アプリアイコン、商品写真、ワイドバナー、スマホ壁紙、風景、ポートレートです。
- qwen-image-3.0-pro/text-to-image の料金は解像度ごとの段階制で、一律価格ではありません：1K は1枚 $0.0497、2K は1枚 $0.0993です。
- API は
inputペイロード内でaspect_ratio+resolutionのみを受け付けます——1024x1024のような生のピクセルサイズを直接渡すことはできません。 - 21:9 のアスペクト比をリクエストすると解像度は 1K に固定されます。この比率には現在 2K のパスがありません。
- 以下の6枚の画像はすべて、実際の未編集のタスク API 出力です——ストック写真もプレースホルダーもありません。
- 完全に動作するプロンプトはすべてそのままコピー＆ペーストできます。被写体を差し替えて構造を保てば、一貫した効果が得られます。
API がサイズ要求をどのように受け取るか
qwen-image-3.0-pro/text-to-image は hiapi のタスク API 上で動作します（POST /v1/tasks、GET /v1/tasks/{id} でポーリング、output[0].url からダウンロード）。input オブジェクトはピクセルサイズではなく、サイズに関連する2つのフィールドを受け取ります：
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3.0-pro/text-to-image",
"input": {
"prompt": "your prompt here",
"aspect_ratio": "16:9",
"resolution": "2K"
}
}'
aspect_ratio は標準セット（1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9、auto）を受け付けます。resolution は 1K または 2K を受け付けます——料金は選択した段階によって変わるため、デフォルトで最大オプションを使うのではなく、意識的に選ぶ価値があります。
1. アプリアイコン——グラデーション背景上のクリーンなベクター被写体
アプリアイコンには、読み取りやすい単一の被写体、コンパクトな構図、そして雑然としないことが必要です。プロンプトに「テキストなし」と「中央配置の構図」を明示的に書かないと、モデルは空白領域を埋めようとします。
A minimalist app icon of a single white paper crane mid-fold, sharp geometric origami creases catching soft light, perched on a small circular teal-to-indigo gradient background inside a rounded square, subtle drop shadow beneath the crane for depth, one thin gold line accent along the crane's spine, flat modern vector-illustration style with crisp clean edges, no text, centered composition with even padding on all sides, app-icon composition
設定：aspect_ratio: 1:1、resolution: 1K——$0.0497
2. 商品写真——無地背景上のスタジオライティング
コマーシャルな商品画像では、表面、光の方向、そして見出し用に残したいネガティブスペースを記述します——qwen-image-3.0-pro/text-to-image は光の方向のヒントに非常によく従います。
Product photography of a tall amber glass perfume bottle with a brushed-silver cap, standing on a slab of dark honed marble, three dried sprigs of lavender resting beside the bottle, soft directional studio light from the upper left casting a long soft shadow to the right, shallow depth of field with a smooth dark-grey gradient background fading to black, a thin rim light tracing the bottle's right edge, generous negative space above the bottle for a headline, realistic commercial product photography, 4:3 aspect ratio
設定：aspect_ratio: 4:3、resolution: 2K——$0.0993
3. ワイドヒーローバナー——21:9 パノラマ構図
21:9 は特殊なケースです：ピクセルサイズではなく比率文字列で直接リクエストし、どのようにリクエストしても現在は 1K 解像度に固定される点に注意してください。
Ultra-wide panoramic photo of a vast white salt flat stretching to the horizon at dusk, a single row of small dark human silhouettes walking in the distance for scale, the wet salt surface perfectly mirroring a sky layered in deep violet, coral pink and burnt orange, a thin band of golden light along the horizon where the sun has just set, minimalist symmetrical composition split evenly between sky and reflection, cinematic wide-format travel photography, extremely wide 21:9 aspect ratio suitable for a hero banner
設定：aspect_ratio: 21:9、resolution: 1K——$0.0497
4. スマホ壁紙——縦長 9:16 の雰囲気
縦長の壁紙は、明確な foreground/background（前景/背景）のレイヤー分けに適しています。そうすればアプリアイコンやウィジェットが上に重なっても構図が読み取れます。
Vertical phone wallpaper photo of a crowded night food-market alley in Taipei, strings of round paper lanterns in red and gold crisscrossing overhead and glowing warmly, a steaming food stall with a striped awning in the near foreground on the left, the alley receding into a soft blur of colorful signage and distant crowds, wet pavement reflecting the lantern light in warm streaks, lively but atmospheric night photography, shallow depth of field with the nearest lantern sharp, tall 9:16 aspect ratio framed for a phone lock screen
設定：aspect_ratio: 9:16、resolution: 2K——$0.0993
5. 風景写真——自然光と雰囲気
自然の情景では、時間帯と単一の前景アンカー被写体（ここでは手漕ぎボート）を指定することで、構図が陳腐に見えるのを避けられます。
Wide landscape photo of a still glassy lake surrounded by dense dark-green pine forest at dawn, thin layers of mist hovering just above the water, a small empty wooden rowboat tied to a weathered dock in the lower-left foreground, low golden sunlight breaking through gaps in the pines on the far shore and catching the mist, muted cool color palette with warm highlights, tranquil nature photography with a strong sense of stillness, 16:9 aspect ratio
設定：aspect_ratio: 16:9、resolution: 2K——$0.0993
6. ポートレート——ドラマチックな光と影のファンタジーアート
キャラクターアートのプロンプトは、肌や素材の描写、シルエットの細部（王冠、髪、襟）、そしてライティングを異なる節に分けるのが最善です——そうすればモデルに長々とした説明ではなく、明確なチェックリストを与えることができます。
Painterly digital portrait of a regal ice queen character from the chest up, pale blue-white skin with faint frost patterns along her cheekbones, sharp angular crown made of translucent icicle shards, flowing silver-white hair with frozen strands drifting as if caught mid-motion, deep sapphire eyes catching a cold rim light, richly detailed fur-and-crystal collar, soft volumetric light from behind creating a glowing halo through falling snow, dramatic fantasy character-art style with fine linework and soft shading, dark navy background fading to black, 3:4 aspect ratio suitable for a poster
設定：aspect_ratio: 3:4、resolution: 2K——$0.0993
これら6つのレシピの総コスト
| レシピ | アスペクト比 | 解像度 | コスト |
|---|---|---|---|
| アプリアイコン | 1:1 | 1K | $0.0497 |
| 商品写真 | 4:3 | 2K | $0.0993 |
| ワイドヒーローバナー | 21:9 | 1K | $0.0497 |
| スマホ壁紙 | 9:16 | 2K | $0.0993 |
| 風景 | 16:9 | 2K | $0.0993 |
| ポートレート | 3:4 | 2K | $0.0993 |
| 合計 | $0.4966 |
料金が一律価格ではなく解像度ごとの段階制であるため、大規模な場面でコストを下げる最速の方法は、2K による追加のディテールが重要でないときにデフォルトで 1K を使うことです——アイコン、サムネイル、小さな UI 素材が 2K を必要とすることはほとんどありませんが、ヒーローバナー、壁紙、印刷向けのポートレートは通常必要とします。
よくある質問
qwen-image-3.0-pro/text-to-image は 1024x1024 のような生のピクセルサイズをサポートしていますか？
いいえ——input ペイロードは aspect_ratio（比率文字列）と resolution（1K または 2K）を受け付け、ピクセル単位の幅/高さは受け付けません。ピクセルベースの API から移行する場合は、まず目標サイズを最も近いサポート対象のアスペクト比に変換してください。
なぜ 21:9 は 1K 解像度のみをサポートしているのですか？ 比率文字列で直接 21:9 をリクエストすると、このモデルは現在 1K にしか解決しません——この比率には現在利用可能な 2K バリアントがありません。
qwen-image-3.0-pro/text-to-image の料金は1枚あたりの固定価格ですか？ いいえ。解像度ごとの段階制です：1K は1枚 $0.0497、2K は1枚 $0.0993——高解像度では約2倍になります。バッチ実行の予算を計画する前に、必ず hiapi の料金ページ で現在のレートを確認してください。
ゼロから生成するのではなく、既存の画像を編集できますか？ はい——qwen-image-3.0-pro は編集や参照ガイド付き生成のための image-to-image バリアントも提供しています。本ガイドは text-to-image パスに特化したものです。
自分で試してみる
完全なパラメータリファレンス、リアルタイムの料金、ブラウザ内 playground は qwen-image-3.0-pro/text-to-image モデルページ にあります。初めての API 呼び出しを設定する場合は、qwen-image-3.0-pro API ガイド が curl と Python の例を最初から最後まで解説しています。前世代モデルのプロンプト性能を比較したい場合は、qwen-image-2.0 プロンプトレシピ を参照してください。そこにもコピー＆ペースト可能な6つのプロンプトがあります。
