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

Z Image Turbo:6種類の構図に対応した画像生成 | RunComfy

tongyi-mai/z-image/turbo/text-to-image

テキストから最大4枚の画像を生成し、サイズ、ステップ数、シード、形式を調整します。

目次

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

1. はじめに

RunComfy の API で tongyi-mai/z-image/turbo/text-to-image を実行します。 受け付ける入出力はモデルの スキーマ。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/tongyi-mai/z-image/turbo/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
  }'

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/tongyi-mai/z-image/turbo/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
  }'

ステータスの確認

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": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "プロンプト",
      "description": "",
      "type": "string",
      "default": "A flash-lit, intimate close-up reveals a front pocket of acid-washed denim jeans, threads softened and grainy with wear. Nestled inside, a cluster of black-and-white photobooth strips peeks out, their glossy surfaces curling and one corner torn, capturing a group of friends mid-smirk. They hold lighters aloft, their faces alive with chaotic joy and youthful rebellion. The hard flash splinters against metal rivets and creased fabric, accentuating the textured weave of denim and the faint creases in the photographs. The composition’s tight crop focuses tension between rough fabric and fleeting memories, conjuring an authentic snapshot of carefree moments preserved in stillness."
    },
    "image_size": {
      "title": "アスペクト比(幅:高さ)",
      "description": "",
      "type": "string",
      "enum": [
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ],
      "default": "landscape_4_3"
    },
    "num_inference_steps": {
      "title": "推論ステップ数",
      "description": "",
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    },
    "num_images": {
      "title": "画像数",
      "description": "生成する画像の数。",
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 1
    },
    "output_format": {
      "title": "出力形式",
      "description": "出力画像形式を指定します。",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "seed": {
      "title": "シード",
      "description": "",
      "type": "integer",
      "default": 0
    }
  }
}

出力スキーマ

{
  "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
  • メール
  • システムステータス
  • アフィリエイト
ビデオモデル
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • すべてのモデルを見る →
画像モデル
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • すべてのモデルを見る →
法的情報
  • 利用規約
  • プライバシーポリシー
  • Cookieポリシー
RunComfy
著作権 2026 RunComfy. All Rights Reserved.

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