logo
RunComfy
  • ComfyUI
  • TrainerNuovo
  • Modelli
  • API
  • Prezzi
discord logo
MODELLI
Esplora
Tutti i modelli
LIBRERIA
Generazioni
API DEI MODELLI
Documentazione API
Chiavi API
ACCOUNT
Utilizzo

Z Image Turbo: da testo a immagine con 6 proporzioni | RunComfy

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

Trasforma il testo in un massimo di quattro immagini e controlla dimensioni, passaggi, seed e formato.

Indice

1. Per iniziare2. Autenticazione3. Riferimento APIInvia una richiestaStato della richiestaRecupera i risultatiAnnulla richiesta4. File in ingressoFile ospitato (URL)5. SchemaSchema di inputSchema di output

1. Per iniziare

Usa l'API RunComfy per eseguire tongyi-mai/z-image/turbo/text-to-image. Per input e output accettati, consulta lo schema.

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. Autenticazione

Imposta la variabile d'ambiente YOUR_API_TOKEN con la tua chiave API (gestione nel Profilo) e includi in ogni richiesta un token Bearer nell'intestazione Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

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."
  }'

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

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

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

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

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

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

4. File in ingresso

File ospitato (URL)

Fornisci un URL HTTPS raggiungibile pubblicamente. L'host deve consentire fetch lato server (senza login/cookie), senza rate limit eccessivo o blocco bot. Consigliato: immagini ≤ 50 MB (~4K), video ≤ 100 MB (~2–5 min a 720p). Per asset privati, URL stabili o pre-firmati.

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "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": "Proporzioni (L:A)",
      "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": "Numero di passaggi di inferenza",
      "description": "",
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    },
    "num_images": {
      "title": "Numero di immagini",
      "description": "Il numero di immagini da generare.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 1
    },
    "output_format": {
      "title": "Formato di output",
      "description": "Specifica il formato dell'immagine di output.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "default": 0
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Seguici
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Supporto
  • Discord
  • Email
  • Stato del Sistema
  • affiliato
Modelli Video
  • 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
  • Visualizza tutti i modelli →
Modelli Immagine
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Visualizza tutti i modelli →
Legale
  • Termini di Servizio
  • Informativa sulla Privacy
  • Informativa sui Cookie
RunComfy
Copyright 2026 RunComfy. Tutti i Diritti Riservati.

RunComfy è la piattaforma principale ComfyUI che offre ComfyUI online ambiente e servizi, insieme a workflow di ComfyUI con visuali mozzafiato. RunComfy offre anche AI Models, consentire agli artisti di sfruttare gli ultimi strumenti di AI per creare arte incredibile.