logo
RunComfy
  • ComfyUI
  • トレーナー新着
  • モデル
  • API
  • 価格
discord logo
モデル
探索
すべてのモデル
ライブラリ
生成履歴
モデルAPI
APIドキュメント
APIキー
アカウント
使用量

Qwen Image 2.1:Models and APIでのテキストから画像への変換と画像編集 | RunComfy

qwen/qwen-image-2.1/edit

Qwen Image 2.1 はテキストから静止画を書き出し、最大10件のリファレンスを編集し、ネイティブの透明度、1K または 2K の出力、およびシードロックを備えています。

目次

1. はじめに2. 認証3. API リファレンスリクエストの送信ステータスの確認結果の取得リクエストのキャンセル4. ファイル入力ホスト済みファイル(URL)5. スキーマ入力スキーマ出力スキーマ

1. はじめに

RunComfy の API で qwen/qwen-image-2.1/edit を実行します。 受け付ける入出力はモデルの スキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
  }'

2. 認証

環境変数 YOUR_API_TOKEN に API キーを設定してください( プロフィールでキー管理)。すべてのリクエストの Authorization ヘッダーに Bearer トークンとして付与: Authorization: Bearer $YOUR_API_TOKEN。

3. API リファレンス

リクエストの送信

非同期の生成ジョブを送信すると、すぐに request_id と、ステータス確認・結果取得・キャンセル用の URL が返ります。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
  }'

ステータスの確認

request_id の現在の状態を取得します("in_queue"、"in_progress"、"completed"、"cancelled")。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

結果の取得

指定した request_id の最終出力とメタデータを取得します。ジョブが未完了の場合は現在の状態が返るため、ポーリングを続けられます。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

リクエストのキャンセル

request_id でキュー中のジョブをキャンセルします。実行中のジョブはキャンセルできません。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. ファイル入力

ホスト済みファイル(URL)

公開到達可能な HTTPS URL を指定してください。サーバー側からの取得が可能で、ログイン不要であること、レート制限やボット遮断がないことを確認してください。目安:画像 ≤ 50 MB(約 4K)、動画 ≤ 100 MB(720p で約 2~5 分)。非公開アセットは安定した URL またはプリサイン URL を推奨します。

5. スキーマ

入力スキーマ

{
  "type": "object",
  "title": "入力スキーマ",
  "required": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "入力画像",
      "description": "参照画像は1から10まで。順序はプロンプトと一致させる(最初の画像、2番目の画像)。JPEG、PNG、またはWebP;各ファイルは30MBおよび25MPまで。人物の特定が鮮明である必要がある場合は、4枚以下に抑えること。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "validations": [
        {
          "validation_rule": "file_size_mb<",
          "validation_value": 30,
          "validation_error": "File size must be less than 30 MB."
        }
      ],
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
      ]
    },
    "prompt": {
      "title": "編集指示",
      "description": "変更をわかりやすい言葉で説明してください:追加するもの、削除するもの、スタイルを変えるもの、または置き換えるもの。引用するテキストはそのまま正確に書きます。マスクを使って、白い部分に何が表示されるべきか説明してください。",
      "type": "string",
      "default": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
    },
    "mask_url": {
      "title": "マスク画像",
      "description": "オプションのモノクロローカル編集マスク。白は変更する領域を示し、黒は残ります。参照画像を正確に1枚必要とし、透過背景とは組み合わせできず、アスペクト比やプロンプトの書き換えは無視されます。",
      "type": "string"
    },
    "aspect_ratio": {
      "title": "アスペクト比(幅:高さ)",
      "description": "出力アスペクト比。auto は最初のリファレンスを使用します。マスクモードでは無視されます。",
      "type": "string",
      "enum": [
        "auto",
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "解像度",
      "description": "出力の詳細レベル。1Kはより速く、2Kは約4倍のピクセル数で、費用が高いです。",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "背景",
      "description": "通常の写真では不透明です。透明は本当のアルファチャンネルを書き込みます — 対象物のみを描写し、JPEG を使用しないでください。マスクと組み合わせることはできません。",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "出力形式",
      "description": "PNG と WebP はアルファチャンネルを持つことができます。JPEG は持てないため、透明な背景と組み合わせることはできません。",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "プロンプトを強化",
      "description": "編集する前に、短い指示をより完全なシーンに書き換えてください。指示がすでに正確な場合はオフにします。マスクモードでは無視されます。",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "シード",
      "description": "再現性のためのランダムシード。毎回ランダムなシードを使用するには -1 を指定してください。",
      "type": "integer",
      "default": -1
    }
  }
}

出力スキーマ

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "単一画像 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "単一動画 URL"
      },
      "images": {
        "type": "array",
        "description": "複数画像 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "複数動画 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
フォローする
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
サポート
  • Discord
  • メール
  • システムステータス
  • アフィリエイト
ビデオモデル
  • Runway Aleph 2
  • Wan 2.5
  • Wan 2.6 Flash
  • MiniMax H3 Max
  • Wan 3.0 Reference To Video
  • Seedance 2.5 Reference to Video 480p
  • すべてのモデルを見る →
画像モデル
  • Wan 2.6 Image to Image
  • Seedream 5.0 Pro
  • Flux 2 Klein 9B
  • Nano Banana Pro
  • Nano Banana 2 Edit
  • Z Image Turbo LoRA
  • すべてのモデルを見る →
法的情報
  • 利用規約
  • プライバシーポリシー
  • Cookieポリシー
RunComfy
著作権 2026 RunComfy. All Rights Reserved.

RunComfyは最高の ComfyUI プラットフォームです。次のものを提供しています: ComfyUIオンライン 環境とサービス、および ComfyUIワークフロー 魅力的なビジュアルが特徴です。 RunComfyはまた提供します AI Models, アーティストが最新のAIツールを活用して素晴らしいアートを作成できるようにする。