リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · デフォルト: 1:1 |
enable_prompt_expansion | いいえ | 短いプロンプトにモデルが詳細を補います。 デフォルト: true |
image_urls | はい | 編集・合成する写真。それぞれの役割をプロンプトに書きます。 |
negative_prompt | いいえ | 入れたくないもの。 |
num_outputs | いいえ | 一度に作る枚数。 ≥ 1 · ≤ 1 · デフォルト: 1 |
prompt | はい | Describe the subject, composition, lighting, and any text to render. |
resolution | いいえ | 出力サイズ。大きいほど鮮明で、料金も上がります。 1k · 2k · デフォルト: 2k |
seed | いいえ | 同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647 |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| resolution 1K | 6 | $0.06 |
| resolution 2K | 11.25 | $0.11 |
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Qwen Image 3.0 Pro API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を alibaba/qwen-image-3.0-pro/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Qwen Image 3.0 Pro API についての質問
Qwen Image 3.0 Pro API の料金はいくらですか?
Qwen Image 3.0 Proの最安は画像を編集で、6クレジット($0.06)/枚からです。オプション別の料金:1K 6クレジット/枚、2K 11.25クレジット/枚。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのQwen Image 3.0 Proのモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は alibaba/qwen-image-3.0-pro/text-to-image;画像を編集は alibaba/qwen-image-3.0-pro/edit を指定します。
Qwen Image 3.0 Pro は Qwen Image 3.0 と何が違いますか?
リクエストの形もフィールドも同じで、ディテールの上限が高いだけです。最も見えやすいのは複数要素の文字組と細かい素材感です。探索は 3.0、納品は Pro です。プロンプトの書き直しは要りません。
1 つの表紙にいくつ文字要素を載せられますか?
短い文字列 3〜4 本が確実な範囲です。マストヘッド、号数、見出し 1〜2 本。それぞれ別々に引用し、置き場所を書いてください。本文の段落はいまも崩れます。
表紙にはどのアスペクト比を使うべきですか?
3:4 か 2:3 です。どちらも最初からその形のために構図が組まれます。正方形を切り抜くのとは違い、被写体も文字も、要求した画面のために配置されます。
既存の表紙を作り直さずに編集できますか?
できます。image-to-image エンドポイントを使ってください。フレームを image_urls に渡し、元の文言と新しい文言を引用し、そのまま残すべきもの——ポーズ、画面の取り方、グレード——をすべて名指しします。
1 つのレイアウトのバリエーションを複数もらえますか?
1 回の呼び出しでは返りません。num_outputs は 1 で固定です。seed を指定せずに同じ指示を並列のリクエストとして送ってください。1 件につき 1 枚が返り、見積もりも 1 件ずつですが、違うのは乱数だけなので読み方同士をそのまま比べられます。
Qwen Image 3.0 Pro API の制限は?
解像度:1K · 2K;アスペクト比:1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2;参照画像:3;プロンプトの長さ(文字):5,000;アップロードの上限:10 MB。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにQwen Image 3.0 Proを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでQwen Image 3.0 Proを実行でき、実行ごとに対応するコードが表示されます。
すべての Qwen Image モデル
Qwen Image 3.0 は同じプロンプトが少し安く使えて、アイデア出しに向いています。Pro は文字組みと細かい質感の上限が高くなります。
- Qwen Image 2.1 Pro API1つのプロンプトから精細な2K画像を最大6枚6クレジットから /枚
- Qwen Image 2.1 Turbo API8ステップの高速レンダー、1回で最大6枚3クレジットから /枚
- Qwen Image 2.1 APIオープンモデル。2K出力、背景透過にも対応4クレジットから /枚
- Qwen Image 2.1 LoRA APIQwen Image 2.1で生成・編集。自分のLoRAを3つまで5クレジットから /枚
- Qwen Image 3.0 Pro API繊細なタイポグラフィに、本物そっくりの肌・布・ガラス6クレジットから /枚
- Qwen Image 3.0 API看板や見出しの文字を、読める形で画像に描き込む5クレジットから /枚
- Qwen Image 2 APIシンプルな画像生成と、写真1枚の編集6クレジットから /枚
- Qwen Image 2512 LoRA APIQwen Image 2512で生成・編集。自分のLoRAを使える5クレジットから /枚
- Qwen Image Edit 2509 LoRA API複数の写真を使うQwen編集。自分のLoRAを読み込める5クレジットから /枚
- Qwen Image 1.0 LoRA API初代Qwen-Image。きれいな文字に自分のLoRAを5クレジットから /枚

