Source: https://ailoot.ai/models/en/openai-dall-e-3/ Canonical: https://ailoot.ai/models/en/openai-dall-e-3/ Language: en # OpenAI: DALL·E 3 [Markdown](https://ailoot.ai/models/en/openai-dall-e-3/index.md) · [JSON](https://ailoot.ai/models/en/openai-dall-e-3/facts.json) ## [OpenAI: DALL·E 3](https://ailoot.ai/models/en/openai-dall-e-3/) DALL·E 3 generates images from a written scene brief. Use the exact openai/dall-e-3 model ID or its dall-e-3 alias with the image-generation method, then save every returned image URL and the accompanying result. A documented starting request produces one 1024x1024 image from text. - [**Ailoot Ultra · Images** `POST /v1/images/generations` `openai/dall-e-3`](https://ailoot.ai/models/en/openai-dall-e-3/#method-0) - [**Ailoot Ultra · Images** `POST /v1/images/generations` `dall-e-3`](https://ailoot.ai/models/en/openai-dall-e-3/#method-1) About the model This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below. DALL·E 3 is OpenAI’s text-to-image model. Use a written brief to create an illustration, a scene concept or a visual direction for a design. Describe the subject, environment, composition, lighting and treatment in the prompt. For example, a concept brief can ask for a delivery bicycle beside a small shop at dusk, viewed from the street, with a clear foreground subject and a restrained colour palette. Send POST /v1/images/generations with an application/json body. The exact public model ID is openai/dall-e-3; the admitted alias dall-e-3 selects the same model card. The documented starting shape supplies model, prompt, n:1 and size:"1024x1024". n is an optional integer and defaults to 1. Send stream:false, or omit stream, for the complete JSON result. Use a nonempty text prompt and keep this request focused on one complete image brief. The offered method is image generation from text. Make the requirements that matter to the placement explicit. An editorial illustration can name the central idea and the objects that express it. A scene concept can specify the camera position, time of day and which parts of the composition need room around them. Keep exact wording that must appear in the image distinct from descriptions of the scene, then inspect the rendered lettering and visual arrangement before using the selected result. The generation response is JSON with a created timestamp and a data array. The documented result item includes url and may include revised\_prompt, prompt\_filter\_results and content\_filter\_results. Preserve those fields with the complete response, and download the image at every returned signed Ailoot URL. Ailoot signed file links last 24 hours from issue. Keep the exact returned URL, including its query string, until the file is saved; determine the saved image format from the actual response or file bytes. Treat the returned image file as the usable design asset and the JSON as its accompanying generation record. Review the image against the supplied brief before placing it in a page, presentation or application. If the response is incomplete or the send outcome is uncertain, preserve the original request identifier and returned information while checking the existing attempt rather than creating another image solely to recover the missing result. To retrieve saved results, use the same API key to GET /v1/media/assets?family=image and follow every next\_cursor. The asset ID appears in each returned /v1/media/assets/{asset\_id}/content URL and in its media-library record. Read GET /v1/media/assets/{asset\_id} for each selected record and download its exact content\_url. If the file request returns 404 with code link\_expired, read that same asset again to obtain a refreshed link. Refreshing an asset link does not require another image-generation request. **Ailoot Ultra · Images** `POST /v1/images/generations` `openai/dall-e-3` [`openai/dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images) OpenAI /`openai/dall-e-3` Model ID - `openai/dall-e-3` - `dall-e-3` ### Overview DALL·E 3 generates images from a written scene brief. Use the exact openai/dall-e-3 model ID or its dall-e-3 alias with the image-generation method, then save every returned image URL and the accompanying result. A documented starting request produces one 1024x1024 image from text. Accepted inputs Text Results Images ### Available in Ailoot · inputs & methods **Ailoot Ultra · Images** `POST /v1/images/generations` Input types `text` Output types `image` Output format Image file | Field | Type | Requirement | Values & limits | Default | | --- | --- | --- | --- | --- | | Field`model` | Type`string` | RequirementRequired | Values & limits openai/dall-e-3 | Default— | | Field`prompt` | Type`string` | RequirementRequired | Values & limits | Default— | | Field`stream` | Type`boolean` | RequirementOptional | Values & limits false | Defaultfalse | | Field`n` | Type`integer` | RequirementOptional | Values & limits 1 | Default— | | Field`size` | Type`string` | RequirementOptional | Values & limits 1024x1024 | Default— | Method parameters and lifecycle | Parameter | Contract | | --- | --- | | Parameter`content_type` | Contractapplication/json | | Parameter`required` | Contractmodel, prompt | | Parameter`optional` | Contractstream, n, size | | Parameter`material_types` | Contracttext | | Parameter`conditions` | ContractUse stream:false or omit stream. The complete buffered JSON result contains all generated images. | Lifecycle: `synchronous_result_then_owned_library` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Pricing ##### How the final charge is calculated The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity. Tariff references do not add request options. Supported parameters are listed for the selected method. Fast mode Not specified When fast mode is selected Flex mode Not specified When flex mode is selected Maximum reasoning effort Not specified When maximum reasoning effort uses the default adjustment #### Estimated rates for comparison #### Prices by configuration Match each charge to the conditions shown. Use one rate for each set of alternative configurations. | Configuration | Rate schedule | Forecast quantity | Charge | | --- | --- | --- | --- | | ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens | | ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Input · Estimated generation cost · Estimate for comparison only **$0.32768** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. | Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/) ### Example requests #### Ailoot Ultra · Images curl · create once and retain the complete result ```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. ``` ### Receive and save results #### Ailoot Ultra · Images Download each returned image or save its Base64 contents - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Keep all completed results Save every completed image; retrieve each returned URL or decode its Base64 contents. Retain every returned image and field. Use owned content\_url values and actual asset\_id records; refresh the same asset when a link expires. ##### If the original response needs checking Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation. ### Aliases #### Model aliases **Ailoot Ultra** [`openai/dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) #### Method path aliases Use the method paths shown above. #### Related caller IDs [`openai/dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/en/#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/en/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) OpenAI /`dall-e-3` Model ID - `openai/dall-e-3` - `dall-e-3` ### Overview DALL·E 3 generates images from a written scene brief. Use the exact openai/dall-e-3 model ID or its dall-e-3 alias with the image-generation method, then save every returned image URL and the accompanying result. A documented starting request produces one 1024x1024 image from text. Accepted inputs Text Results Images ### Available in Ailoot · inputs & methods **Ailoot Ultra · Images** `POST /v1/images/generations` Input types `text` Output types `image` Output format Image file | Field | Type | Requirement | Values & limits | Default | | --- | --- | --- | --- | --- | | Field`model` | Type`string` | RequirementRequired | Values & limits dall-e-3 | Default— | | Field`prompt` | Type`string` | RequirementRequired | Values & limits | Default— | | Field`stream` | Type`boolean` | RequirementOptional | Values & limits false | Defaultfalse | | Field`n` | Type`integer` | RequirementOptional | Values & limits 1 | Default— | | Field`size` | Type`string` | RequirementOptional | Values & limits 1024x1024 | Default— | Method parameters and lifecycle | Parameter | Contract | | --- | --- | | Parameter`content_type` | Contractapplication/json | | Parameter`required` | Contractmodel, prompt | | Parameter`optional` | Contractstream, n, size | | Parameter`material_types` | Contracttext | | Parameter`conditions` | ContractUse stream:false or omit stream. The complete buffered JSON result contains all generated images. | Lifecycle: `synchronous_result_then_owned_library` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Pricing ##### How the final charge is calculated The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity. Tariff references do not add request options. Supported parameters are listed for the selected method. Fast mode Not specified When fast mode is selected Flex mode Not specified When flex mode is selected Maximum reasoning effort Not specified When maximum reasoning effort uses the default adjustment #### Estimated rates for comparison #### Prices by configuration Match each charge to the conditions shown. Use one rate for each set of alternative configurations. | Configuration | Rate schedule | Forecast quantity | Charge | | --- | --- | --- | --- | | ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens | | ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Input · Estimated generation cost · Estimate for comparison only **$0.32768** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. | Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/) ### Example requests #### Ailoot Ultra · Images curl · create once and retain the complete result ```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. ``` ### Receive and save results #### Ailoot Ultra · Images Download each returned image or save its Base64 contents - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Keep all completed results Save every completed image; retrieve each returned URL or decode its Base64 contents. Retain every returned image and field. Use owned content\_url values and actual asset\_id records; refresh the same asset when a link expires. ##### If the original response needs checking Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation. ### Aliases #### Model aliases **Ailoot Ultra** [`openai/dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) #### Method path aliases Use the method paths shown above. #### Related caller IDs [`openai/dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=openai%2Fdall-e-3&fmt=images), [`dall-e-3`](https://ailoot.ai/models/en/#m=openai%2Fdall-e-3&route=Ultra&caller=dall-e-3&fmt=images) FAQ · OpenAI: DALL·E 3 What inputs and results are available? `POST /v1/images/generations` · `openai/dall-e-3`: `text` → `image` `POST /v1/images/generations` · `dall-e-3`: `text` → `image` Which fields does the request use? `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` Connect Ailoot to Claude Code, OpenCode, Hermes or your own app. ## The company and its project portfolio The company and its project portfolio: millions of customers; monthly sales in the billions. ## Buy tokens at a discount. Subscription discounts for regular use. Promo codes offer up to 50% off token purchases. Subscription Choose a discounted plan for your regular requests. Promo code: up to 50% off Enter your code at checkout. The price updates to reflect the current promotion. Spending in your history The model, tokens and amount are recorded for each request. [Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/) ## Connect the API to a product you sell. Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale. Commercial application Add text, image, video and audio generation to paid features in your service. Reseller licence Send a description of your project and how you provide access. Request written terms for use and resale. Documents on the website The service offer, licence agreement and data processing policy are available before you connect. [Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en) ## Ailoot · The company and its project portfolio Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control. The company and its project portfolio: millions of customers; monthly sales in the billions. Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.