Qwen Image 3.0 画像を編集 API：生成と編集・最大2K

Name: Qwen Image 3.0 API
SKU: alibaba/qwen-image-3.0/edit
Price: 0.05 USD
Availability: InStock

リクエストパラメーター

パラメーター	必須	説明
`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
標準	4.5	$0.045

タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 5クレジット/枚（$0.05）です。

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

Qwen Image 3.0 API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
リクエストを送る. POST /jobs/createTask に、model を alibaba/qwen-image-3.0/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/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 API についての質問

Qwen Image 3.0 API の料金はいくらですか？

Qwen Image 3.0の最安は画像を編集で、5クレジット（$0.05）/枚からです。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのQwen Image 3.0のモデル名は？

POST /jobs/createTask の model フィールドに画像を作成は alibaba/qwen-image-3.0/text-to-image；画像を編集は alibaba/qwen-image-3.0/edit を指定します。

画像の中に実際どれくらい文字を描けますか？

短い文字列はよく持ちこたえます。見出し、看板、商品ラベル、おおむね 8 語以下の見出し文です。段落全体はいまも崩れます。文字が入るものは 2k の段で生成してください。

1 リクエストで何枚返せますか？

1 枚です。num_outputs は 1 で固定なので、1 リクエストで返るのは 1 枚で、見積もりと精算も 1 件ずつです。同じ指示で複数の候補が欲しいときは、seed を指定せずにリクエストを並列に送ってください。

image-to-image は text-to-image と何が違いますか？

画像編集では、参照 1〜3 枚の image_urls 配列が必須として加わり、他のフィールドはすべてそのままです。どの参照が何を担当するのかはプロンプトで書いてください。モデルは役割を割り当ててくれません。

中国語のプロンプトを読めますか？

読めます。そのまま解釈され、設定すべき言語パラメータはありません。5,000 文字の予算もどちらでも同じで、引用文字列の扱いも変わりません。

同じ画像を 2 回出せますか？

seed を固定するとランダムな変動を抑えられますが、完全に同じ結果は保証されません。

Qwen Image 3.0 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を試せますか？

はい。Playground なら API キーなしで、PopNow のクレジットでQwen Image 3.0を実行でき、実行ごとに対応するコードが表示されます。

すべての Qwen Image モデル

Qwen Image 3.0 Pro は、複数行の文字組みと細かい質感で、最終フレームの上限を引き上げます。

ほかの画像 API

Qwen Image 3.0 についてさらに

試す: Qwen Image 3.0 のAI画像生成をオンラインで PopNow で Qwen Image 3.0 を使って画像を作る
ドキュメント: API ドキュメントの Qwen Image 3.0 モデル ID と入力スキーマ PopNow API クイックスタート：5 分で最初のリクエスト PopNow API 画像生成ガイド Webhook：ポーリングせずに Qwen Image 3.0 の結果を受け取る