Source: https://ailoot.ai/models/pt-pt/openai-dall-e-3/ Canonical: https://ailoot.ai/models/pt-pt/openai-dall-e-3/ Language: pt-pt # OpenAI: DALL·E 3 [Markdown](https://ailoot.ai/models/pt-pt/openai-dall-e-3/index.md) · [JSON](https://ailoot.ai/models/pt-pt/openai-dall-e-3/facts.json) ## [OpenAI: DALL·E 3](https://ailoot.ai/models/pt-pt/openai-dall-e-3/) DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto. - [**Ailoot Ultra · Images** `POST /v1/images/generations` `openai/dall-e-3`](https://ailoot.ai/models/pt-pt/openai-dall-e-3/#method-0) - [**Ailoot Ultra · Images** `POST /v1/images/generations` `dall-e-3`](https://ailoot.ai/models/pt-pt/openai-dall-e-3/#method-1) 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. DALL·E 3 é o modelo de texto para imagem da OpenAI. Utilize uma descrição escrita para criar uma ilustração, um conceito de cena ou uma orientação visual para um design. Descreva no prompt o tema, o ambiente, a composição, a iluminação e o tratamento visual. Por exemplo, uma descrição de conceito pode pedir uma bicicleta de entregas junto de uma pequena loja ao anoitecer, vista da rua, com um sujeito claro em primeiro plano e uma paleta de cores contida. Envie POST /v1/images/generations com um corpo application/json. O ID público exato do modelo é openai/dall-e-3; o alias admitido dall-e-3 seleciona a mesma ficha de modelo. A estrutura inicial documentada fornece model, prompt, n:1 e size:"1024x1024". n é um número inteiro opcional e tem 1 como valor predefinido. Envie stream:false ou omita stream para obter o resultado JSON completo. Utilize um prompt de texto não vazio e mantenha este pedido focado numa descrição completa de uma imagem. O método disponibilizado é a geração de imagens a partir de texto. Torne explícitos os requisitos importantes para o local de utilização. Uma ilustração editorial pode indicar a ideia central e os objetos que a expressam. Um conceito de cena pode especificar a posição da câmara, a hora do dia e as partes da composição que precisam de espaço em redor. Mantenha a formulação exata que deve aparecer na imagem separada das descrições da cena e inspecione depois o texto desenhado e a disposição visual antes de utilizar o resultado selecionado. A resposta de geração é JSON com um carimbo temporal created e um array data. O elemento de resultado documentado inclui url e pode incluir revised\_prompt, prompt\_filter\_results e content\_filter\_results. Preserve esses campos com a resposta completa e transfira a imagem de cada URL assinado do Ailoot devolvido. As ligações assinadas do Ailoot para ficheiros duram 24 horas a partir da emissão. Conserve o URL exato devolvido, incluindo a sua cadeia de consulta, até o ficheiro estar guardado; determine o formato da imagem guardada a partir da resposta real ou dos bytes do ficheiro. Trate o ficheiro de imagem devolvido como o recurso de design utilizável e o JSON como o registo da geração que o acompanha. Compare a imagem com a descrição fornecida antes de a inserir numa página, apresentação ou aplicação. Se a resposta estiver incompleta ou o resultado do envio for incerto, preserve o identificador do pedido original e as informações devolvidas enquanto verifica a tentativa existente, em vez de criar outra imagem apenas para recuperar o resultado em falta. Para obter resultados guardados, utilize a mesma chave de API para GET /v1/media/assets?family=image e percorra todos os next\_cursor. O ID do recurso aparece em cada URL /v1/media/assets/{asset\_id}/content devolvido e no respetivo registo da biblioteca multimédia. Consulte GET /v1/media/assets/{asset\_id} para cada registo selecionado e transfira o respetivo content\_url exato. Se o pedido de ficheiro devolver 404 com o código link\_expired, consulte novamente o mesmo recurso para obter uma ligação renovada. Renovar a ligação de um recurso não exige outro pedido de geração de imagens. **Ailoot Ultra · Images** `POST /v1/images/generations` `openai/dall-e-3` [`openai/dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images) OpenAI /`openai/dall-e-3` ID do modelo - `openai/dall-e-3` - `dall-e-3` ### Introdução DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto. Entradas aceites Texto Resultados Imagens ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Images** `POST /v1/images/generations` Entrada `text` Saída `image` Formato de saída Ficheiro de imagem | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites openai/dall-e-3 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`stream` | Tipo`boolean` | RequisitoOpcional | Valores e limites false | Predefiniçãofalse | | Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites 1 | Predefinição— | | Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 1024x1024 | 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`optional` | Contratostream, n, size | | Parâmetro`material_types` | Contratotext | | Parâmetro`conditions` | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. | Ciclo de vida: `synchronous_result_then_owned_library` `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 | Custo | | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | 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çãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação **$0.32768** estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. | 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 · Images curl · crie uma única vez e guarde o resultado completo ```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=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}') 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 # Submit once. Retain the complete result, original identifiers and every response header. ``` ### Receber e guardar os resultados #### Ailoot Ultra · Images Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64 - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Guardar todos os resultados concluídos Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64. Retain every returned image and field. Use owned content\_url values and actual asset\_id records; refresh the same asset when a link expires. ##### Se for necessário verificar a resposta original Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation. ### Aliases #### Aliases do modelo **Ailoot Ultra** [`openai/dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`openai/dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) **Ailoot Ultra · Images** `POST /v1/images/generations` `dall-e-3` [`dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) OpenAI /`dall-e-3` ID do modelo - `openai/dall-e-3` - `dall-e-3` ### Introdução DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto. Entradas aceites Texto Resultados Imagens ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Images** `POST /v1/images/generations` Entrada `text` Saída `image` Formato de saída Ficheiro de imagem | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites dall-e-3 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`stream` | Tipo`boolean` | RequisitoOpcional | Valores e limites false | Predefiniçãofalse | | Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites 1 | Predefinição— | | Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 1024x1024 | 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`optional` | Contratostream, n, size | | Parâmetro`material_types` | Contratotext | | Parâmetro`conditions` | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. | Ciclo de vida: `synchronous_result_then_owned_library` `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 | Custo | | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | 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çãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação **$0.32768** estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. | 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 · Images curl · crie uma única vez e guarde o resultado completo ```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=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}') 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 # Submit once. Retain the complete result, original identifiers and every response header. ``` ### Receber e guardar os resultados #### Ailoot Ultra · Images Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64 - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Guardar todos os resultados concluídos Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64. Retain every returned image and field. Use owned content\_url values and actual asset\_id records; refresh the same asset when a link expires. ##### Se for necessário verificar a resposta original Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation. ### Aliases #### Aliases do modelo **Ailoot Ultra** [`openai/dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`openai/dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/pt-pt/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) FAQ · OpenAI: DALL·E 3 Que entradas e resultados estão disponíveis? `POST /v1/images/generations` · `openai/dall-e-3`: `text` → `image` `POST /v1/images/generations` · `dall-e-3`: `text` → `image` Que campos utiliza o pedido? `POST /v1/images/generations` · `openai/dall-e-3`: `model`, `prompt`, `stream`, `n`, `size` `POST /v1/images/generations` · `dall-e-3`: `model`, `prompt`, `stream`, `n`, `size` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.