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.
", "aboutText": "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.\n\nSend 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.\n\nMake 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.\n\nThe 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.\n\nTreat 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "173226e430dab3b61705408a85d4a2c2de7866d5d284b1039c4b70a05dce468a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "openai/dall-e-3DALL·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.
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.
POST /v1/images/generationstextimage| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits openai/dall-e-3 | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits | Default— |
Fieldstream | Typeboolean | RequirementOptional | Values & limits false | Defaultfalse |
Fieldn | Typeinteger | RequirementOptional | Values & limits 1 | Default— |
Fieldsize | Typestring | RequirementOptional | Values & limits 1024x1024 | Default— |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractstream, n, size |
Parametermaterial_types | Contracttext |
Parameterconditions | 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}
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.
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 →
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=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\nDownload each returned image or save its Base64 contents
GET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Ailoot Ultra openai/dall-e-3, dall-e-3
Use the method paths shown above.
dall-e-3DALL·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.
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.
POST /v1/images/generationstextimage| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits dall-e-3 | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits | Default— |
Fieldstream | Typeboolean | RequirementOptional | Values & limits false | Defaultfalse |
Fieldn | Typeinteger | RequirementOptional | Values & limits 1 | Default— |
Fieldsize | Typestring | RequirementOptional | Values & limits 1024x1024 | Default— |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractstream, n, size |
Parametermaterial_types | Contracttext |
Parameterconditions | 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}
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.
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 →
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=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\nDownload each returned image or save its Base64 contents
GET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Ailoot Ultra openai/dall-e-3, dall-e-3
Use the method paths shown above.