Qwen-Image-3.0 Pro é o modelo de referência de terceira geração da Qwen para geração e edição de imagens. Combina a criação de composições complexas, texturas realistas detalhadas, tipografia multilingue e cumprimento rigoroso de instruções para a imagem. Pro e a edição padrão Qwen-Image-3.0 partilham os modos documentados de geração e edição; Pro destaca a qualidade da imagem, enquanto a edição padrão equilibra qualidade e velocidade. O resultado é um ficheiro de imagem renderizada.
Para uma peça gráfica com muita informação, defina o conteúdo antes do aspeto: o título, o texto de apoio, os números, a hierarquia e a relação entre secções. Um pedido de produto útil pode combinar um objeto principal, detalhes de materiais em grande plano e características identificadas com etiquetas numa única tela. Para uma ilustração educativa, identifique o conceito, a estrutura do diagrama e as legendas exatas, em vez de depender do modelo para inventar os factos subjacentes. As composições complexas também podem apresentar vários painéis ou interfaces aninhadas. Mantenha o máximo recomendado de 4 500 tokens para o prompt focado no que deve aparecer e onde pertence.
A família 3.0 suporta tipografia nativa em 12 idiomas, vários tipos de letra e mais de 100 estilos artísticos, juntamente com texturas finas como cabelo, pele ou tecido. Está demonstrada a renderização de texto pequeno mesmo com um tamanho de apenas 10 píxeis. Isto permite um design que integre letras num material físico ou combine texto com imagens realistas. Forneça as palavras exatas, os algarismos e o idioma e descreva o papel tipográfico de cada bloco. Uma página de jornal ou uma maquete de interface continua a ser uma imagem; qualquer disposição editável ou comportamento interativo posterior é um resultado separado a construir a partir dela.
Pro pode editar texto dentro de uma imagem, acrescentar, eliminar ou mover elementos, alterar a ação de um sujeito, transferir estilo visual e melhorar detalhes. A edição aceita uma a três imagens de entrada com uma instrução. A sua ordem determina a imagem 1, a imagem 2 e a imagem 3 no pedido. Especifique qual a referência que fornece a identidade do sujeito, qual fornece um objeto ou vestuário e qual contribui com um cenário ou uma pose. Uma edição focada indica tanto a alteração pretendida como as características que devem permanecer intactas, facilitando a comparação da imagem resultante com as referências.
As entradas suportadas são JPG, JPEG, PNG, BMP, TIFF, WebP e GIF, usando apenas o primeiro frame de GIFs animados. Cada imagem de entrada pode ter até 10 MB. A API exata aceita lados de 1 a 8 000 píxeis e uma relação entre o lado maior e o menor não superior a 10:1; o intervalo recomendado é de 384–2 048 píxeis. O guia de edição recomenda separadamente imagens até 3 072 píxeis; por isso, trate a escolha da entrada como preparação para o detalhe necessário, e não como uma promessa de que todas as resoluções melhoram o resultado. Use uma referência legível e adequadamente enquadrada para texto muito pequeno ou características dos materiais.
As saídas são PNG. O fluxo do produtor devolve uma a seis alternativas, com uma por predefinição, e suporta uma área total de píxeis de 512 × 512 a 2 048 × 2 048, com proporções de 1:8 a 8:1. O orçamento de área de píxeis permite algumas dimensões não quadradas cujo lado maior excede 2 048 píxeis. Quando não se especifica o tamanho, o modelo recomenda uma resolução baseada no pedido. Escolha a forma para o local real de utilização e compare depois as alternativas geradas quanto à completude do conteúdo, aos detalhes do sujeito e à tipografia no tamanho de apresentação pretendido.
A reformulação inteligente do prompt está ativada por predefinição. A melhoria direta está disponível tanto para geração como para edição, enquanto a melhoria por agente aperfeiçoa prompts de texto para imagem e não pode ser usada na edição de imagem para imagem. Thinking também está ativado por predefinição e requer reformulação do prompt; acrescenta trabalho de raciocínio e tempo de geração. Os prompts negativos identificam elementos indesejados, e um valor seed opcional pode ajudar a tornar as comparações entre variantes mais consistentes. Um pedido positivo claro deve, ainda assim, estabelecer o sujeito, a composição e os detalhes a preservar.
Uma revisão prática do resultado verifica o texto exato, os números, a ordem de leitura, a fidelidade às referências e as arestas ou texturas relevantes para o design. Quando uma parte específica necessita de revisão, preserve a composição bem-sucedida e descreva a alteração focada. Mantenha todas as imagens escolhidas junto do prompt e das referências, pois os endereços de saída do produtor expiram após 24 horas. Os modos e limites documentados de Pro pertencem à edição 3.0; as funcionalidades de dez referências e transparência nativa descritas para Qwen 2.1 são capacidades de uma edição separada.
", "aboutText": "Qwen-Image-3.0 Pro é o modelo de referência de terceira geração da Qwen para geração e edição de imagens. Combina a criação de composições complexas, texturas realistas detalhadas, tipografia multilingue e cumprimento rigoroso de instruções para a imagem. Pro e a edição padrão Qwen-Image-3.0 partilham os modos documentados de geração e edição; Pro destaca a qualidade da imagem, enquanto a edição padrão equilibra qualidade e velocidade. O resultado é um ficheiro de imagem renderizada.\n\nPara uma peça gráfica com muita informação, defina o conteúdo antes do aspeto: o título, o texto de apoio, os números, a hierarquia e a relação entre secções. Um pedido de produto útil pode combinar um objeto principal, detalhes de materiais em grande plano e características identificadas com etiquetas numa única tela. Para uma ilustração educativa, identifique o conceito, a estrutura do diagrama e as legendas exatas, em vez de depender do modelo para inventar os factos subjacentes. As composições complexas também podem apresentar vários painéis ou interfaces aninhadas. Mantenha o máximo recomendado de 4 500 tokens para o prompt focado no que deve aparecer e onde pertence.\n\nA família 3.0 suporta tipografia nativa em 12 idiomas, vários tipos de letra e mais de 100 estilos artísticos, juntamente com texturas finas como cabelo, pele ou tecido. Está demonstrada a renderização de texto pequeno mesmo com um tamanho de apenas 10 píxeis. Isto permite um design que integre letras num material físico ou combine texto com imagens realistas. Forneça as palavras exatas, os algarismos e o idioma e descreva o papel tipográfico de cada bloco. Uma página de jornal ou uma maquete de interface continua a ser uma imagem; qualquer disposição editável ou comportamento interativo posterior é um resultado separado a construir a partir dela.\n\nPro pode editar texto dentro de uma imagem, acrescentar, eliminar ou mover elementos, alterar a ação de um sujeito, transferir estilo visual e melhorar detalhes. A edição aceita uma a três imagens de entrada com uma instrução. A sua ordem determina a imagem 1, a imagem 2 e a imagem 3 no pedido. Especifique qual a referência que fornece a identidade do sujeito, qual fornece um objeto ou vestuário e qual contribui com um cenário ou uma pose. Uma edição focada indica tanto a alteração pretendida como as características que devem permanecer intactas, facilitando a comparação da imagem resultante com as referências.\n\nAs entradas suportadas são JPG, JPEG, PNG, BMP, TIFF, WebP e GIF, usando apenas o primeiro frame de GIFs animados. Cada imagem de entrada pode ter até 10 MB. A API exata aceita lados de 1 a 8 000 píxeis e uma relação entre o lado maior e o menor não superior a 10:1; o intervalo recomendado é de 384–2 048 píxeis. O guia de edição recomenda separadamente imagens até 3 072 píxeis; por isso, trate a escolha da entrada como preparação para o detalhe necessário, e não como uma promessa de que todas as resoluções melhoram o resultado. Use uma referência legível e adequadamente enquadrada para texto muito pequeno ou características dos materiais.\n\nAs saídas são PNG. O fluxo do produtor devolve uma a seis alternativas, com uma por predefinição, e suporta uma área total de píxeis de 512 × 512 a 2 048 × 2 048, com proporções de 1:8 a 8:1. O orçamento de área de píxeis permite algumas dimensões não quadradas cujo lado maior excede 2 048 píxeis. Quando não se especifica o tamanho, o modelo recomenda uma resolução baseada no pedido. Escolha a forma para o local real de utilização e compare depois as alternativas geradas quanto à completude do conteúdo, aos detalhes do sujeito e à tipografia no tamanho de apresentação pretendido.\n\nA reformulação inteligente do prompt está ativada por predefinição. A melhoria direta está disponível tanto para geração como para edição, enquanto a melhoria por agente aperfeiçoa prompts de texto para imagem e não pode ser usada na edição de imagem para imagem. Thinking também está ativado por predefinição e requer reformulação do prompt; acrescenta trabalho de raciocínio e tempo de geração. Os prompts negativos identificam elementos indesejados, e um valor seed opcional pode ajudar a tornar as comparações entre variantes mais consistentes. Um pedido positivo claro deve, ainda assim, estabelecer o sujeito, a composição e os detalhes a preservar.\n\nUma revisão prática do resultado verifica o texto exato, os números, a ordem de leitura, a fidelidade às referências e as arestas ou texturas relevantes para o design. Quando uma parte específica necessita de revisão, preserve a composição bem-sucedida e descreva a alteração focada. Mantenha todas as imagens escolhidas junto do prompt e das referências, pois os endereços de saída do produtor expiram após 24 horas. Os modos e limites documentados de Pro pertencem à edição 3.0; as funcionalidades de dez referências e transparência nativa descritas para Qwen 2.1 são capacidades de uma edição separada.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "69edef5831e32c688e21a91d1ce047fedfa1caa104e3bfc2ddd3bd0857f099ff", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "qwen/qwen-image-3-proQwen-Image-3.0 Pro é o modelo de referência da Qwen para geração e edição de imagens, com composições complexas, detalhes realistas e texto multilingue. Use instruções precisas ou uma a três referências para criar uma peça gráfica, uma cena de produto ou uma edição visual focada.
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 Pro é o modelo de referência de terceira geração da Qwen para geração e edição de imagens. Combina a criação de composições complexas, texturas realistas detalhadas, tipografia multilingue e cumprimento rigoroso de instruções para a imagem. Pro e a edição padrão Qwen-Image-3.0 partilham os modos documentados de geração e edição; Pro destaca a qualidade da imagem, enquanto a edição padrão equilibra qualidade e velocidade. O resultado é um ficheiro de imagem renderizada.
Para uma peça gráfica com muita informação, defina o conteúdo antes do aspeto: o título, o texto de apoio, os números, a hierarquia e a relação entre secções. Um pedido de produto útil pode combinar um objeto principal, detalhes de materiais em grande plano e características identificadas com etiquetas numa única tela. Para uma ilustração educativa, identifique o conceito, a estrutura do diagrama e as legendas exatas, em vez de depender do modelo para inventar os factos subjacentes. As composições complexas também podem apresentar vários painéis ou interfaces aninhadas. Mantenha o máximo recomendado de 4 500 tokens para o prompt focado no que deve aparecer e onde pertence.
A família 3.0 suporta tipografia nativa em 12 idiomas, vários tipos de letra e mais de 100 estilos artísticos, juntamente com texturas finas como cabelo, pele ou tecido. Está demonstrada a renderização de texto pequeno mesmo com um tamanho de apenas 10 píxeis. Isto permite um design que integre letras num material físico ou combine texto com imagens realistas. Forneça as palavras exatas, os algarismos e o idioma e descreva o papel tipográfico de cada bloco. Uma página de jornal ou uma maquete de interface continua a ser uma imagem; qualquer disposição editável ou comportamento interativo posterior é um resultado separado a construir a partir dela.
Pro pode editar texto dentro de uma imagem, acrescentar, eliminar ou mover elementos, alterar a ação de um sujeito, transferir estilo visual e melhorar detalhes. A edição aceita uma a três imagens de entrada com uma instrução. A sua ordem determina a imagem 1, a imagem 2 e a imagem 3 no pedido. Especifique qual a referência que fornece a identidade do sujeito, qual fornece um objeto ou vestuário e qual contribui com um cenário ou uma pose. Uma edição focada indica tanto a alteração pretendida como as características que devem permanecer intactas, facilitando a comparação da imagem resultante com as referências.
As entradas suportadas são JPG, JPEG, PNG, BMP, TIFF, WebP e GIF, usando apenas o primeiro frame de GIFs animados. Cada imagem de entrada pode ter até 10 MB. A API exata aceita lados de 1 a 8 000 píxeis e uma relação entre o lado maior e o menor não superior a 10:1; o intervalo recomendado é de 384–2 048 píxeis. O guia de edição recomenda separadamente imagens até 3 072 píxeis; por isso, trate a escolha da entrada como preparação para o detalhe necessário, e não como uma promessa de que todas as resoluções melhoram o resultado. Use uma referência legível e adequadamente enquadrada para texto muito pequeno ou características dos materiais.
As saídas são PNG. O fluxo do produtor devolve uma a seis alternativas, com uma por predefinição, e suporta uma área total de píxeis de 512 × 512 a 2 048 × 2 048, com proporções de 1:8 a 8:1. O orçamento de área de píxeis permite algumas dimensões não quadradas cujo lado maior excede 2 048 píxeis. Quando não se especifica o tamanho, o modelo recomenda uma resolução baseada no pedido. Escolha a forma para o local real de utilização e compare depois as alternativas geradas quanto à completude do conteúdo, aos detalhes do sujeito e à tipografia no tamanho de apresentação pretendido.
A reformulação inteligente do prompt está ativada por predefinição. A melhoria direta está disponível tanto para geração como para edição, enquanto a melhoria por agente aperfeiçoa prompts de texto para imagem e não pode ser usada na edição de imagem para imagem. Thinking também está ativado por predefinição e requer reformulação do prompt; acrescenta trabalho de raciocínio e tempo de geração. Os prompts negativos identificam elementos indesejados, e um valor seed opcional pode ajudar a tornar as comparações entre variantes mais consistentes. Um pedido positivo claro deve, ainda assim, estabelecer o sujeito, a composição e os detalhes a preservar.
Uma revisão prática do resultado verifica o texto exato, os números, a ordem de leitura, a fidelidade às referências e as arestas ou texturas relevantes para o design. Quando uma parte específica necessita de revisão, preserve a composição bem-sucedida e descreva a alteração focada. Mantenha todas as imagens escolhidas junto do prompt e das referências, pois os endereços de saída do produtor expiram após 24 horas. Os modos e limites documentados de Pro pertencem à edição 3.0; as funcionalidades de dez referências e transparência nativa descritas para Qwen 2.1 são capacidades de uma edição separada.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites qwen/qwen-image-3-pro | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 1K, 2K | Predefinição— |
Campoaspect_ratio | Tipostring | 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— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 6 | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 0 Número máximo de elementos: 4 | Predefinição— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetromaterial_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}
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.
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.08 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nDescarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nGuarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Conserve a resposta completa e os cabeçalhos, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação.
Guarde o X-Client-Request-ID devolvido para reconciliação. Consulte apenas os valores task_id/asset_id efetivamente devolvidos ou a sua biblioteca de multimédia; nunca construa um URL de tarefa a partir do ID da operação e nunca volte a enviar o pedido de criação.
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Ailoot Ultra qwen/qwen-image-3-pro
/v1/images