logo
RunComfy
  • ComfyUI
  • TreinadorNovo
  • Modelos
  • API
  • Preços
discord logo
MODELOS
Explorar
Todos os modelos
BIBLIOTECA
Gerações
APIS DE MODELOS
Documentação da API
Chaves API
CONTA
Uso

Z Image Turbo: texto para imagem com 6 proporções | RunComfy

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

Transforme texto em até quatro imagens e controle tamanho, etapas, seed e formato.

Índice

1. Introdução2. Autenticação3. Referência da APIEnviar uma solicitaçãoStatus da solicitaçãoObter resultadosCancelar solicitação4. Arquivos de entradaArquivo hospedado (URL)5. EsquemaEsquema de entradaEsquema de saída

1. Introdução

Use a API RunComfy para executar tongyi-mai/z-image/turbo/text-to-image. Para entradas e saídas aceitas, consulte o esquema.

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. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

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

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

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

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

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

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

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

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "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": "Proporção (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": "Número de etapas de inferência",
      "description": "",
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    },
    "num_images": {
      "title": "Número de imagens",
      "description": "O número de imagens a serem geradas.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 1
    },
    "output_format": {
      "title": "Formato de saída",
      "description": "Especifica o formato da imagem de saída.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "default": 0
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Siga-nos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Suporte
  • Discord
  • E-mail
  • Status do Sistema
  • afiliado
Modelos de Vídeo
  • 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
  • Ver todos os modelos →
Modelos de Imagem
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Ver todos os modelos →
Legal
  • Termos de Serviço
  • Política de Privacidade
  • Política de Cookies
RunComfy
Copyright 2026 RunComfy. Todos os Direitos Reservados.

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.