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

Qwen Image 2.1 T2I: Texto-para-Imagem com Transparência no Models and API | RunComfy

qwen/qwen-image-2.1/text-to-image

Qwen Image 2.1 T2I transforma prompts de texto em 1K ou 2K imagens estáticas com controle de proporção, transparência nativa, reescrita de prompt e bloqueio de semente.

Í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 qwen/qwen-image-2.1/text-to-image. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

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/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

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": "Descreva o assunto, o cenário, o estilo e qualquer texto exato que você queira que seja reproduzido. Coloque as palavras entre aspas para que sejam reproduzidas literalmente.",
      "type": "string",
      "default": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
    },
    "aspect_ratio": {
      "title": "Proporção (L:A)",
      "description": "Proporção de aspecto de saída. O tamanho do pixel também depende do nível de resolução.",
      "type": "string",
      "enum": [
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "1:1"
    },
    "resolution": {
      "title": "Resolução",
      "description": "Nível de detalhes de saída. 1K é mais rápido; 2K tem cerca de quatro vezes os pixels e custa mais.",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "Fundo",
      "description": "opaco para uma foto comum. transparente escreve um canal alfa real — descreva apenas o sujeito e não use JPEG.",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "Formato de saída",
      "description": "PNG e WebP podem conter um canal alfa. JPEG não pode, então não pode ser combinado com um fundo transparente.",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "Melhorar o prompt",
      "description": "Reescreva um prompt curto em uma cena mais completa antes de gerar. Desative quando seu prompt já estiver exato.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Semente aleatória para reprodutibilidade. Use -1 para uma semente aleatória a cada execução.",
      "type": "integer",
      "default": -1
    }
  }
}

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
  • 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
  • Ver todos os modelos →
Modelos de Imagem
  • 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
  • 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.