ToAPIsToAPIs
Qwen Image 3.0

Qwen Image 3.0 画像生成

qwen-image-3.0 または qwen-image-3.0-pro で画像を生成します

POST
/v1/images/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • qwen-image-3.0 と qwen-image-3.0-pro に対応
  • テキストからの画像生成、画像編集、複数参照画像に対応
  • 参照画像は最大 3 枚
  • 1K / 2K と 7 種類のアスペクト比に対応
  • 1 リクエストにつき 1 枚のみ生成。n は 1 に固定
  • 非同期タスクとして実行し、タスク ID で結果を取得

image_urls は公開アクセス可能な画像 URL のみ対応します。base64 Data URI は使用できません。ローカル画像は先に画像アップロード APIでアップロードしてください。

対応モデル

モデルテキストから画像画像から画像参照画像出力
qwen-image-3.0対応対応最大 3 枚1 枚固定
qwen-image-3.0-pro対応対応最大 3 枚1 枚固定

Authorizations

Authorizationstringヘッダー必須

すべての API は Bearer Token 認証が必要です。

API Key 管理ページでキーを取得し、次のヘッダーを送信します。

Authorization: Bearer YOUR_API_KEY

Body

modelstringボディ必須

モデル名。使用できる値は次の 2 つです。

  • qwen-image-3.0
  • qwen-image-3.0-pro
promptstringボディ必須

画像の説明または編集指示。空文字列は指定できません。

sizestringボディ

出力画像のアスペクト比:

1:1、4:3、3:4、16:9、9:16、3:2、2:3

WIDTH*HEIGHT または WIDTHxHEIGHT のピクセル指定も使用できます。総ピクセル数は 512*512 から 2048*2048、アスペクト比は 1:8 から 8:1 の範囲にしてください。省略時はモデルがサイズを選択します。

resolutionstringボディデフォルト: 1K

size にアスペクト比を指定した場合の解像度:

  • 1K - デフォルト
  • 2K

metadata.resolution も使用できますが、トップレベルの指定を推奨します。

nintegerボディデフォルト: 1

生成枚数。1 に固定されています。2 以上を指定すると 400 invalid_request になります。

image_urlsstring[]ボディ

画像編集、画像から画像、複数参照に使用する画像 URL の配列です。

client_business_idstringボディ

注文 ID など、クライアント側の業務 ID。指定すると同じステータス API でこの ID を使って照会できます。

metadataobjectボディ

Qwen Image の高度なパラメータです。

metadata のプロパティ
metadata.prompt_extendbooleanボディデフォルト: true

プロンプトを自動的に最適化・拡張するかどうか。

metadata.prompt_extend_modestringボディ

拡張モード。direct、またはテキストから画像の場合のみ agent。image_urls がある場合、agent は自動的に direct になります。

metadata.negative_promptstringボディ

生成したくない内容を指定するネガティブプロンプト。

metadata.seedintegerボディ

乱数シード。同じ結果を保証するものではありませんが、近い結果の生成に役立ちます。

metadata.watermarkbooleanボディデフォルト: false

ウォーターマークを追加するかどうか。

解像度とピクセルサイズ

アスペクト比を指定した場合、両モデルで次のピクセルサイズに変換されます。

比率1K2K
1:11024×10242048×2048
4:31152×8641600×1200
3:4864×11521200×1600
16:91280×7201920×1080
9:16720×12801080×1920
3:21152×7681728×1152
2:3768×11521152×1728

Response

idstring
ステータス照会に使用するタスク ID。
objectstring
常に generation.task。
modelstring
使用したモデル。
statusstring
queued、in_progress、completed、failed。
progressinteger
0 から 100 の進捗率。
created_atinteger
Unix タイムスタンプの作成時刻。

リクエスト例

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-3.0",
    "prompt": "雲海の上にある古都、金色の朝日、映画ポスターの構図、読みやすい日本語タイトル",
    "size": "16:9",
    "resolution": "2K",
    "n": 1,
    "metadata": {
      "prompt_extend": true,
      "negative_prompt": "ぼやけ、低品質、文字化け",
      "watermark": false
    }
  }'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-3.0-pro",
    "prompt": "1 枚目の人物と 2 枚目の衣装を維持し、現代的な雑誌表紙にしてください",
    "image_urls": [
      "https://example.com/person.png",
      "https://example.com/outfit.png"
    ],
    "size": "3:4",
    "resolution": "2K",
    "n": 1
  }'

タスクの送信結果

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "qwen-image-3.0-pro",
  "status": "queued",
  "progress": 0,
  "created_at": 1787270400
}

タスクの照会

curl --request GET \
  --url https://toapis.com/v1/images/generations/task_img_abc123def456 \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

レスポンスの詳細とポーリング方法は画像タスクのステータス取得を参照してください。

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "qwen-image-3.0-pro",
  "status": "completed",
  "progress": 100,
  "result": {
    "type": "image",
    "data": [
      { "url": "https://files.toapis.com/generated/qwen-image-result.png" }
    ]
  }
}
生成画像は 30 日間保存されます. expires_at より前に保存してください.

料金

  • 成功した出力:1 リクエスト $0.03
  • 参照画像:1 枚 $0.003
  • 参照画像の無料枠はありません
  • 2 つのモデルは現在同じ料金ルールです