Source: https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/ Canonical: https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/ Language: pt-pt # Qwen: Qwen Image 3 [Markdown](https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/index.md) · [JSON](https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/facts.json) ## [Qwen: Qwen Image 3](https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/) Qwen-Image-3.0 combina geração e edição de imagens para composições ricas em informação, cenas detalhadas e tipografia multilingue. A edição padrão equilibra qualidade e rapidez, aceitando uma descrição textual ou até três imagens com uma instrução de edição. - [**Ailoot Ultra · Imagens** `POST /v1/images/generations` `qwen/qwen-image-3`](https://ailoot.ai/models/pt-pt/qwen-qwen-image-3/#method-0) Sobre o modelo Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo. Qwen-Image-3.0 é o modelo de imagem de terceira geração da Qwen, que combina criação de imagens a partir de texto e edição baseada em referências num único modelo. A edição padrão equilibra a qualidade da imagem e a rapidez de resposta, enquanto Qwen-Image-3.0 Pro é a edição de topo da mesma família, orientada para a qualidade. Um pedido produz uma imagem: um cartaz, uma explicação ilustrada, uma cena de produto, um storyboard ou uma fotografia revista, e não um documento editável ou uma interface funcional. As suas capacidades de conteúdo rico adequam-se a uma composição com várias secções relacionadas ou uma organização visual com elementos encaixados. Prepare os títulos, a redação exata, a hierarquia e a relação entre os painéis antes de acrescentar pormenores de estilo. Para uma comparação de produtos, uma indicação útil especifica a vista principal do produto, os atributos a identificar e a ordem de leitura dos painéis de apoio. Para um storyboard, descreva separadamente o tema, a ação e a legenda de cada painel. O máximo recomendado para o prompt é de 4 500 tokens; utilize esse espaço para o conteúdo e a composição de que a imagem realmente precisa. O modelo suporta texturas detalhadas, tipografia que chega a texto pequeno demonstrado com 10 píxeis e composição nativa em 12 línguas, com várias fontes e estilos artísticos. Estas capacidades permitem combinar um objeto realista com um grafismo rico em informação, em vez de obrigar a escolher entre uma fotografia e uma composição com muito texto. Forneça as palavras e os algarismos exatos a representar, a língua pretendida e o local onde devem aparecer. Trate uma interface gerada como uma maquete visual: os botões, gráficos e etiquetas na imagem não implementam o comportamento de uma aplicação. A edição permite alterar texto, acrescentar ou remover objetos, mover elementos, ajustar a ação de um sujeito, transferir um estilo ou melhorar os detalhes de uma imagem danificada. Forneça entre uma e três imagens e uma única instrução de edição clara. A numeração das imagens segue a ordem fornecida, pelo que deve identificar qual fornece o sujeito, qual fornece uma peça de roupa ou objeto e qual fornece o cenário. Para uma cena de produto, peça que o objeto da imagem 1 seja colocado no ambiente da imagem 2, preservando as características que distinguem o produto. Explicite as alterações e os requisitos de preservação. O processo específico de entrada de imagens aceita JPG, JPEG, PNG, BMP, TIFF, WebP e GIF; num GIF animado, apenas o primeiro fotograma é processado. Cada imagem pode ter até 10 MB. A API atual aceita dimensões de 1 a 8 000 píxeis, com uma proporção máxima de 10:1 entre o lado maior e o menor, e recomenda 384–2 048 píxeis para bons resultados. Escolha uma entrada que mostre claramente os detalhes a transferir ou editar. Uma referência com um recorte demasiado apertado pode ocultar a estrutura envolvente necessária para colocar um objeto de forma natural. A saída é PNG, com uma a seis imagens por pedido e uma por predefinição. A área em píxeis da saída varia de 512 × 512 a 2 048 × 2 048, com proporções entre 1:8 e 8:1; estes são limites de área, não uma regra segundo a qual cada lado tenha, no máximo, 2 048 píxeis. Se não for fornecido um tamanho, o modelo recomenda uma resolução a partir do prompt. Selecione uma composição horizontal, quadrada ou vertical para a utilização pretendida e examine depois a imagem devolvida nesse tamanho real, para avaliar as etiquetas pequenas e os detalhes finos no local onde irão aparecer. A reescrita do prompt está ativada por predefinição no processo do fabricante. A melhoria direta funciona tanto na geração como na edição; a melhoria com agente é um modo de reescrita mais elaborado, apenas para geração de imagens a partir de texto, e é rejeitada na edição de imagem para imagem. Thinking está ativado por predefinição, exige a reescrita do prompt e aumenta o tempo de geração. Os prompts negativos podem descrever elementos indesejados, enquanto uma seed fixa ajuda a comparar variações. Indique claramente as exclusões e os requisitos exatos de preservação, em vez de esperar que uma seed produza uma imagem idêntica quando a descrição muda. Para obter um resultado final útil, examine as palavras representadas, as unidades, a ordem dos painéis e os detalhes que identificam o sujeito, e reveja depois a parte específica que não cumpriu a indicação. Uma resposta com várias imagens fornece alternativas para comparação; mantenha cada imagem devolvida associada ao prompt e às referências que a produziram. Os endereços das imagens do fabricante expiram ao fim de 24 horas, pelo que deve conservar o ficheiro de imagem propriamente dito quando o resultado passar a integrar um projeto. A edição padrão 3.0 continua distinta de Pro e dos modelos Qwen 2.1, que têm diferentes quantidades de referências e funcionalidades de transparência. **Ailoot Ultra · Imagens** `POST /v1/images/generations` `qwen/qwen-image-3` [`qwen/qwen-image-3`](https://ailoot.ai/models/pt-pt/#m=qwen%2Fqwen-image-3&route=Ultra&caller=qwen%2Fqwen-image-3&fmt=images) Alibaba /`qwen/qwen-image-3` ### Introdução Qwen-Image-3.0 combina geração e edição de imagens para composições ricas em informação, cenas detalhadas e tipografia multilingue. A edição padrão equilibra qualidade e rapidez, aceitando uma descrição textual ou até três imagens com uma instrução de edição. Entradas aceites Texto · Imagens Resultados Imagens ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Imagens** `POST /v1/images/generations` Entrada `text`, `image` Saída `image` | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites qwen/qwen-image-3 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— | | Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores e limites 1K, 2K | Predefinição— | | Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Predefinição— | | Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 | Predefinição— | | Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites Número mínimo de elementos: 0 Número máximo de elementos: 4 | Predefinição— | | Campo`provider` | Tipo`object` | RequisitoOpcional | Valores e limites | Predefinição— | Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, prompt | | Parâmetro`material_types` | Contratotext, image | Ciclo de vida: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · task\_id efetivamente devolvido ou registo na biblioteca de multimédia `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tarifários ##### Cálculo do custo final As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável. As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado. Modo rápido Não especificado Quando o modo rápido está selecionado Modo flex Não especificado Quando o modo flex está selecionado Esforço máximo de raciocínio Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default) #### Tarifas estimadas para comparação #### Preços por configuração Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas. | Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Custo | | --- | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens | | Configuraçãoimagem de entrada | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor imagem de entrada | Custo Entrada · imagem de entrada · Estimativa apenas para comparação **$0.006** por imagem de entrada | | ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.06** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. | O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Imagens curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"