Qwen Image 3.0 Pro API 接入：curl、Python と全パラメータ

Qwen Image 3.0 Pro（通義千問画像 3.0 Pro）は HiAPI 上で2つのエンドポイントを持ちます。テキスト・トゥ・イメージの qwen-image-3.0-pro/text-to-image と、イメージ・トゥ・イメージの qwen-image-3.0-pro/image-to-image です。標準版より高価ですが、その分だけディテールと質感が豊かで、中国語・英語の文字も正確に書けます。この記事ではそのまま実行できる curl と Python のサンプル、現行の全パラメータ、そしてリリース前に注意すべき点をいくつか示します。

以前のモデル名 qwen-image-3.0-pro と size フィールドはすでに使えません。旧モデル名は MODEL_UNAVAILABLE を返し、size は未知のフィールドとして拒否されます。上記2つのモデル名を使い、aspect_ratio と resolution を組み合わせてください。

まず価格

	1K（デフォルト）	2K
Pro テキスト・トゥ・イメージ / イメージ・トゥ・イメージ	$0.0497	$0.0993
標準版 テキスト・トゥ・イメージ / イメージ・トゥ・イメージ（比較用）	$0.0358	$0.0358

HiAPI 現行価格、2026 年 10 月 18 日確認。

Pro の 1K は標準版より約 39% 高く、2K は標準版の約 2.8 倍です。イメージ・トゥ・イメージの参照画像 1〜3 枚は追加料金なし。失敗時は課金されません。

実際の生成例

16:9。テーブル上の真鍮プレートの「深海来信」と、その下の小さな一行「LETTERS FROM THE DEEP」がどちらも一字一句正しく書けています：

High-end cinematic architectural editorial photograph inside a futuristic underwater restaurant at midnight. A vast curved observation window fills the background with deep cobalt water and luminous translucent jellyfish drifting outside. On the right, a sculptural dining table of black stone, hand-blown glass and restrained brushed brass catches a narrow beam of warm light. A small refined brass menu plaque on the table is naturally photographed and contains only the exact Chinese characters “深海来信”; directly below, the exact English words “LETTERS FROM THE DEEP”. The left third remains calm dark-blue negative space with volumetric light rays. No poster layout; this must feel like an expensive real location photographed for an architecture magazine. cinematic composition, dramatic directional lighting, rich cohesive cobalt-and-gold color grade, ultra-detailed, premium commercial finish, subtle film grain, shallow depth of field, high dynamic range, 16:9 hero composition

このプロンプトで生成 →

qwen-image-3.0-pro/text-to-image、16:9、モデルページのサンプル画像。

最初の1枚を動かす

準備：コンソール で API Key を作成します。新規ユーザー登録で 200 クレジットが付与されます。

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
      "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
      "aspect_ratio": "4:3",
      "resolution": "1K",
      "prompt_extend": false
    }
  }'

taskId が返ったら結果を確認します：

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

data.status が success のとき、画像は data.output[0].url にあります。これは一時リンクなので、取得したらすぐにダウンロードして保存してください。

Python

import os, time, requests

KEY = os.environ["HIAPI_KEY"]
BASE = "https://api.hiapi.ai/v1"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

r = requests.post(f"{BASE}/tasks", headers=H, json={
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
        "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
        "aspect_ratio": "4:3",
        "resolution": "1K",
        "prompt_extend": False,
    },
})
task_id = r.json()["data"]["taskId"]

while True:
    d = requests.get(f"{BASE}/tasks/{task_id}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

if d["status"] == "success":
    open("result.png", "wb").write(requests.get(d["output"][0]["url"]).content)
else:
    print(d)

全パラメータ

フィールド	必須	値	説明
prompt	はい	最大 18000 文字	画面内容、スタイル、構図。表示させたい文字は引用符で囲んで書く
image_urls	イメージ・トゥ・イメージでは必須	1〜3 枚	JPEG/PNG/WEBP/BMP/GIF/TIFF、1枚 ≤10MB、SVG 非対応
aspect_ratio	いいえ	1:1（デフォルト）、3:2、2:3、4:3、3:4、16:9、9:16、21:9
resolution	いいえ	1K（デフォルト）/ 2K	価格を決める
output_format	いいえ	png（デフォルト）/ jpeg
prompt_extend	いいえ	ブール値、デフォルト true	プロンプトを自動で書き換える。文字を一字一句違わずに出すなら false に設定
negative_prompt	いいえ	最大 500 文字	出したくない内容
seed	いいえ	0–2147483647	固定すると再現しやすい

イメージ・トゥ・イメージの例：

{
  "model": "qwen-image-3.0-pro/image-to-image",
  "input": {
    "prompt": "把这张产品图修成高端杂志风格，保留瓶身形状和标签上的文字",
    "image_urls": ["https://example.com/product.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "prompt_extend": false
  }
}

よくあるエラー

いずれも送信時に同期的に HTTP 400 を返し、タスクは作成されず課金もされません：

• MODEL_UNAVAILABLE：旧モデル名 qwen-image-3.0-pro を使っています。/text-to-image または /image-to-image 付きの名前に変更してください。
• additional properties 'size' not allowed：size は受け付けなくなりました。aspect_ratio と resolution を使ってください。
• resolution: value must be one of '1K', '2K'：Pro に 4K はありません。
• image_urls: minItems: got 0, want 1：イメージ・トゥ・イメージでは参照画像を少なくとも 1 枚渡してください。

リリース前の注意

• 文字を書かせるときは prompt_extend をオフに：自動書き換えで指定した文字が変わることがあります。
• ポーリングの代わりにコールバックを使う：リクエストボディのトップレベルに "callback": {"url": "https://あなたのドメイン/hiapi/callback", "when": "final"} を追加し、taskId で重複排除します。
• 二重課金の防止：送信時に Idempotency-Key リクエストヘッダーを付け、タイムアウトで再試行するときも同じ key を使います。
• 早めに保存：出力リンクは期限切れになります。

よくある質問

Pro と標準版はどう選ぶ？

まず標準版で試してください。1枚 $0.0358 で、1K と 2K が同価格です。標準版でディテールが足りないときに Pro に切り替えましょう。標準版の接入は Qwen Image 3.0 API 接入 を参照。

4K は出せますか？

出せません。1K と 2K のみです。

参照画像は最大何枚？

3 枚まで、追加料金なし。

上記の海底レストランのプロンプトをそのままコピーして、モデルページで生成 できます。