{ "aboutHtml": "

DALL·E 3 הוא מודל הטקסט לתמונה של OpenAI. השתמשו בתיאור כתוב כדי ליצור איור, קונספט לסצנה או כיוון חזותי לעיצוב. תארו ב-prompt את הנושא, הסביבה, הקומפוזיציה, התאורה והעיבוד. למשל, תיאור קונספט יכול לבקש אופני משלוחים לצד חנות קטנה בשעת דמדומים, במבט מהרחוב, עם נושא ברור בקדמת התמונה ופלטת צבעים מאופקת.

שלחו POST /v1/images/generations עם גוף application/json. מזהה המודל הציבורי המדויק הוא openai/dall-e-3; הכינוי המורשה dall-e-3 בוחר באותו כרטיס מודל. מבנה הפתיחה המתועד מספק model, prompt, n:1 ו-size:"1024x1024". n הוא מספר שלם אופציונלי וברירת המחדל שלו היא 1. שלחו stream:false, או השמיטו את stream, לקבלת תוצאת JSON מלאה. השתמשו ב-prompt טקסטואלי שאינו ריק ושמרו על הבקשה ממוקדת בתיאור תמונה שלם אחד. המתודה המוצעת היא יצירת תמונות מטקסט.

נסחו במפורש את הדרישות החשובות למיקום התמונה. איור לכתבה יכול לציין את הרעיון המרכזי ואת העצמים המבטאים אותו. קונספט לסצנה יכול להגדיר את מיקום המצלמה, השעה ביום ואילו חלקים בקומפוזיציה צריכים מרחב סביבם. הפרידו נוסח מדויק שחייב להופיע בתמונה מתיאורי הסצנה, ואז בדקו את הכיתוב שנוצר ואת הסידור החזותי לפני השימוש בתוצאה הנבחרת.

תגובת היצירה היא JSON עם חותמת זמן created ומערך data. פריט התוצאה המתועד כולל url ועשוי לכלול revised_prompt, prompt_filter_results ו-content_filter_results. שימרו את השדות האלה עם התגובה המלאה, והורידו את התמונה מכל כתובת URL חתומה של Ailoot שהוחזרה. קישורי קבצים חתומים של Ailoot תקפים ל-24 שעות ממועד הנפקתם. שמרו את כתובת ה-URL המדויקת שהוחזרה, כולל מחרוזת השאילתה שלה, עד שהקובץ נשמר; קבעו את פורמט התמונה שנשמרה מתוך התגובה בפועל או בתי הקובץ.

התייחסו לקובץ התמונה שהוחזר כנכס העיצוב השימושי ול-JSON כרשומת היצירה הנלווית שלו. בדקו את התמונה מול התיאור שסופק לפני שילובה בעמוד, במצגת או ביישום. אם התגובה חלקית או שתוצאת השליחה אינה ודאית, שימרו את מזהה הבקשה המקורי ואת המידע שהוחזר בעת בדיקת הניסיון הקיים, במקום ליצור תמונה נוספת רק כדי לשחזר תוצאה חסרה. לשליפת תוצאות שנשמרו, השתמשו באותו מפתח API לביצוע GET /v1/media/assets?family=image ועקבו אחר כל next_cursor. מזהה הנכס מופיע בכל כתובת URL שהוחזרה מסוג /v1/media/assets/{asset_id}/content וברשומת ספריית המדיה שלו. קראו GET /v1/media/assets/{asset_id} לכל רשומה שנבחרה והורידו את content_url המדויק שלה. אם בקשת הקובץ מחזירה 404 עם הקוד link_expired, קראו שוב את אותו נכס לקבלת קישור מעודכן. רענון קישור נכס אינו דורש בקשת יצירת תמונה נוספת.

", "aboutText": "DALL·E 3 הוא מודל הטקסט לתמונה של OpenAI. השתמשו בתיאור כתוב כדי ליצור איור, קונספט לסצנה או כיוון חזותי לעיצוב. תארו ב-prompt את הנושא, הסביבה, הקומפוזיציה, התאורה והעיבוד. למשל, תיאור קונספט יכול לבקש אופני משלוחים לצד חנות קטנה בשעת דמדומים, במבט מהרחוב, עם נושא ברור בקדמת התמונה ופלטת צבעים מאופקת.\n\nשלחו POST /v1/images/generations עם גוף application/json. מזהה המודל הציבורי המדויק הוא openai/dall-e-3; הכינוי המורשה dall-e-3 בוחר באותו כרטיס מודל. מבנה הפתיחה המתועד מספק model, prompt, n:1 ו-size:\"1024x1024\". n הוא מספר שלם אופציונלי וברירת המחדל שלו היא 1. שלחו stream:false, או השמיטו את stream, לקבלת תוצאת JSON מלאה. השתמשו ב-prompt טקסטואלי שאינו ריק ושמרו על הבקשה ממוקדת בתיאור תמונה שלם אחד. המתודה המוצעת היא יצירת תמונות מטקסט.\n\nנסחו במפורש את הדרישות החשובות למיקום התמונה. איור לכתבה יכול לציין את הרעיון המרכזי ואת העצמים המבטאים אותו. קונספט לסצנה יכול להגדיר את מיקום המצלמה, השעה ביום ואילו חלקים בקומפוזיציה צריכים מרחב סביבם. הפרידו נוסח מדויק שחייב להופיע בתמונה מתיאורי הסצנה, ואז בדקו את הכיתוב שנוצר ואת הסידור החזותי לפני השימוש בתוצאה הנבחרת.\n\nתגובת היצירה היא JSON עם חותמת זמן created ומערך data. פריט התוצאה המתועד כולל url ועשוי לכלול revised_prompt, prompt_filter_results ו-content_filter_results. שימרו את השדות האלה עם התגובה המלאה, והורידו את התמונה מכל כתובת URL חתומה של Ailoot שהוחזרה. קישורי קבצים חתומים של Ailoot תקפים ל-24 שעות ממועד הנפקתם. שמרו את כתובת ה-URL המדויקת שהוחזרה, כולל מחרוזת השאילתה שלה, עד שהקובץ נשמר; קבעו את פורמט התמונה שנשמרה מתוך התגובה בפועל או בתי הקובץ.\n\nהתייחסו לקובץ התמונה שהוחזר כנכס העיצוב השימושי ול-JSON כרשומת היצירה הנלווית שלו. בדקו את התמונה מול התיאור שסופק לפני שילובה בעמוד, במצגת או ביישום. אם התגובה חלקית או שתוצאת השליחה אינה ודאית, שימרו את מזהה הבקשה המקורי ואת המידע שהוחזר בעת בדיקת הניסיון הקיים, במקום ליצור תמונה נוספת רק כדי לשחזר תוצאה חסרה. לשליפת תוצאות שנשמרו, השתמשו באותו מפתח API לביצוע GET /v1/media/assets?family=image ועקבו אחר כל next_cursor. מזהה הנכס מופיע בכל כתובת URL שהוחזרה מסוג /v1/media/assets/{asset_id}/content וברשומת ספריית המדיה שלו. קראו GET /v1/media/assets/{asset_id} לכל רשומה שנבחרה והורידו את content_url המדויק שלה. אם בקשת הקובץ מחזירה 404 עם הקוד link_expired, קראו שוב את אותו נכס לקבלת קישור מעודכן. רענון קישור נכס אינו דורש בקשת יצירת תמונה נוספת.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "93bfc9ade33bef72455ec63541090afbcd30b854a7d6d9698b03628d5c13c21b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "
O

OpenAI: DALL·E 3

OpenAI /openai/dall-e-3

התחלה

DALL·E 3 יוצר תמונות מתיאור סצנה כתוב. השתמשו במזהה המודל המדויק openai/dall-e-3 או בכינוי שלו dall-e-3 עם מתודת יצירת התמונות, ואז שמרו כל כתובת URL לתמונה שהוחזרה ואת התוצאה הנלווית. בקשת פתיחה מתועדת מפיקה תמונה אחת בגודל 1024x1024 מטקסט.

סוגי קלט נתמכים
טקסט
תוצאות
תמונות
על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

DALL·E 3 הוא מודל הטקסט לתמונה של OpenAI. השתמשו בתיאור כתוב כדי ליצור איור, קונספט לסצנה או כיוון חזותי לעיצוב. תארו ב-prompt את הנושא, הסביבה, הקומפוזיציה, התאורה והעיבוד. למשל, תיאור קונספט יכול לבקש אופני משלוחים לצד חנות קטנה בשעת דמדומים, במבט מהרחוב, עם נושא ברור בקדמת התמונה ופלטת צבעים מאופקת.

שלחו POST /v1/images/generations עם גוף application/json. מזהה המודל הציבורי המדויק הוא openai/dall-e-3; הכינוי המורשה dall-e-3 בוחר באותו כרטיס מודל. מבנה הפתיחה המתועד מספק model, prompt, n:1 ו-size:"1024x1024". n הוא מספר שלם אופציונלי וברירת המחדל שלו היא 1. שלחו stream:false, או השמיטו את stream, לקבלת תוצאת JSON מלאה. השתמשו ב-prompt טקסטואלי שאינו ריק ושמרו על הבקשה ממוקדת בתיאור תמונה שלם אחד. המתודה המוצעת היא יצירת תמונות מטקסט.

נסחו במפורש את הדרישות החשובות למיקום התמונה. איור לכתבה יכול לציין את הרעיון המרכזי ואת העצמים המבטאים אותו. קונספט לסצנה יכול להגדיר את מיקום המצלמה, השעה ביום ואילו חלקים בקומפוזיציה צריכים מרחב סביבם. הפרידו נוסח מדויק שחייב להופיע בתמונה מתיאורי הסצנה, ואז בדקו את הכיתוב שנוצר ואת הסידור החזותי לפני השימוש בתוצאה הנבחרת.

תגובת היצירה היא JSON עם חותמת זמן created ומערך data. פריט התוצאה המתועד כולל url ועשוי לכלול revised_prompt, prompt_filter_results ו-content_filter_results. שימרו את השדות האלה עם התגובה המלאה, והורידו את התמונה מכל כתובת URL חתומה של Ailoot שהוחזרה. קישורי קבצים חתומים של Ailoot תקפים ל-24 שעות ממועד הנפקתם. שמרו את כתובת ה-URL המדויקת שהוחזרה, כולל מחרוזת השאילתה שלה, עד שהקובץ נשמר; קבעו את פורמט התמונה שנשמרה מתוך התגובה בפועל או בתי הקובץ.

התייחסו לקובץ התמונה שהוחזר כנכס העיצוב השימושי ול-JSON כרשומת היצירה הנלווית שלו. בדקו את התמונה מול התיאור שסופק לפני שילובה בעמוד, במצגת או ביישום. אם התגובה חלקית או שתוצאת השליחה אינה ודאית, שימרו את מזהה הבקשה המקורי ואת המידע שהוחזר בעת בדיקת הניסיון הקיים, במקום ליצור תמונה נוספת רק כדי לשחזר תוצאה חסרה. לשליפת תוצאות שנשמרו, השתמשו באותו מפתח API לביצוע GET /v1/media/assets?family=image ועקבו אחר כל next_cursor. מזהה הנכס מופיע בכל כתובת URL שהוחזרה מסוג /v1/media/assets/{asset_id}/content וברשומת ספריית המדיה שלו. קראו GET /v1/media/assets/{asset_id} לכל רשומה שנבחרה והורידו את content_url המדויק שלה. אם בקשת הקובץ מחזירה 404 עם הקוד link_expired, קראו שוב את אותו נכס לקבלת קישור מעודכן. רענון קישור נכס אינו דורש בקשת יצירת תמונה נוספת.

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · Images POST /v1/images/generations
סוגי קלט
text
סוגי פלט
image
פורמט פלט
קובץ תמונה
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
openai/dall-e-3
ברירת מחדל—
שדהpromptסוגstringדרישהחובהערכים ומגבלותברירת מחדל—
שדהstreamסוגbooleanדרישהרשותערכים ומגבלות
false
ברירת מחדלfalse
שדהnסוגintegerדרישהרשותערכים ומגבלות
⁦1⁩
ברירת מחדל—
שדהsizeסוגstringדרישהרשותערכים ומגבלות
1024x1024
ברירת מחדל—
פרמטרים ומחזור חיים של השיטה
פרמטרמפרט
פרמטרcontent_typeמפרטapplication/json
פרמטרrequiredמפרטmodel, prompt
פרמטרoptionalמפרטstream, n, size
פרמטרmaterial_typesמפרטtext
פרמטרconditionsמפרטUse stream:false or omit stream. The complete buffered JSON result contains all generated images.

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.

מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.

מצב מהיר
לא צוין כאשר נבחר מצב מהיר
מצב Flex
לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי
לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורהטבלת תעריפיםכמות חזויהחיוב
תצורהתעריפי בסיס לטוקניםטבלת תעריפיםתעריף בסיסכמות חזויה—חיוב
קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים
פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים
קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהEstimated generation costטבלת תעריפים—כמות חזויהאומדן ליצירה אחתחיוב
קלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.32768 אומדן לפני היצירה

This estimate is not an additional charge or a fixed rate for the completed generation.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · Images

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.\n

קבלה ושמירה של תוצאות

Ailoot Ultra · Images

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-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.

כשצריך לבדוק את התגובה המקורית

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

כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

מזהי מודלים קשורים IDs

openai/dall-e-3, dall-e-3

", "method_identity": { "effective_request_model_id": "openai/dall-e-3", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "openai/dall-e-3", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|openai%2Fdall-e-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "openai/dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "openai/dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "openai/dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } }, { "html": "
O

OpenAI: DALL·E 3

OpenAI /dall-e-3

התחלה

DALL·E 3 יוצר תמונות מתיאור סצנה כתוב. השתמשו במזהה המודל המדויק openai/dall-e-3 או בכינוי שלו dall-e-3 עם מתודת יצירת התמונות, ואז שמרו כל כתובת URL לתמונה שהוחזרה ואת התוצאה הנלווית. בקשת פתיחה מתועדת מפיקה תמונה אחת בגודל 1024x1024 מטקסט.

סוגי קלט נתמכים
טקסט
תוצאות
תמונות
על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

DALL·E 3 הוא מודל הטקסט לתמונה של OpenAI. השתמשו בתיאור כתוב כדי ליצור איור, קונספט לסצנה או כיוון חזותי לעיצוב. תארו ב-prompt את הנושא, הסביבה, הקומפוזיציה, התאורה והעיבוד. למשל, תיאור קונספט יכול לבקש אופני משלוחים לצד חנות קטנה בשעת דמדומים, במבט מהרחוב, עם נושא ברור בקדמת התמונה ופלטת צבעים מאופקת.

שלחו POST /v1/images/generations עם גוף application/json. מזהה המודל הציבורי המדויק הוא openai/dall-e-3; הכינוי המורשה dall-e-3 בוחר באותו כרטיס מודל. מבנה הפתיחה המתועד מספק model, prompt, n:1 ו-size:"1024x1024". n הוא מספר שלם אופציונלי וברירת המחדל שלו היא 1. שלחו stream:false, או השמיטו את stream, לקבלת תוצאת JSON מלאה. השתמשו ב-prompt טקסטואלי שאינו ריק ושמרו על הבקשה ממוקדת בתיאור תמונה שלם אחד. המתודה המוצעת היא יצירת תמונות מטקסט.

נסחו במפורש את הדרישות החשובות למיקום התמונה. איור לכתבה יכול לציין את הרעיון המרכזי ואת העצמים המבטאים אותו. קונספט לסצנה יכול להגדיר את מיקום המצלמה, השעה ביום ואילו חלקים בקומפוזיציה צריכים מרחב סביבם. הפרידו נוסח מדויק שחייב להופיע בתמונה מתיאורי הסצנה, ואז בדקו את הכיתוב שנוצר ואת הסידור החזותי לפני השימוש בתוצאה הנבחרת.

תגובת היצירה היא JSON עם חותמת זמן created ומערך data. פריט התוצאה המתועד כולל url ועשוי לכלול revised_prompt, prompt_filter_results ו-content_filter_results. שימרו את השדות האלה עם התגובה המלאה, והורידו את התמונה מכל כתובת URL חתומה של Ailoot שהוחזרה. קישורי קבצים חתומים של Ailoot תקפים ל-24 שעות ממועד הנפקתם. שמרו את כתובת ה-URL המדויקת שהוחזרה, כולל מחרוזת השאילתה שלה, עד שהקובץ נשמר; קבעו את פורמט התמונה שנשמרה מתוך התגובה בפועל או בתי הקובץ.

התייחסו לקובץ התמונה שהוחזר כנכס העיצוב השימושי ול-JSON כרשומת היצירה הנלווית שלו. בדקו את התמונה מול התיאור שסופק לפני שילובה בעמוד, במצגת או ביישום. אם התגובה חלקית או שתוצאת השליחה אינה ודאית, שימרו את מזהה הבקשה המקורי ואת המידע שהוחזר בעת בדיקת הניסיון הקיים, במקום ליצור תמונה נוספת רק כדי לשחזר תוצאה חסרה. לשליפת תוצאות שנשמרו, השתמשו באותו מפתח API לביצוע GET /v1/media/assets?family=image ועקבו אחר כל next_cursor. מזהה הנכס מופיע בכל כתובת URL שהוחזרה מסוג /v1/media/assets/{asset_id}/content וברשומת ספריית המדיה שלו. קראו GET /v1/media/assets/{asset_id} לכל רשומה שנבחרה והורידו את content_url המדויק שלה. אם בקשת הקובץ מחזירה 404 עם הקוד link_expired, קראו שוב את אותו נכס לקבלת קישור מעודכן. רענון קישור נכס אינו דורש בקשת יצירת תמונה נוספת.

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · Images POST /v1/images/generations
סוגי קלט
text
סוגי פלט
image
פורמט פלט
קובץ תמונה
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
dall-e-3
ברירת מחדל—
שדהpromptסוגstringדרישהחובהערכים ומגבלותברירת מחדל—
שדהstreamסוגbooleanדרישהרשותערכים ומגבלות
false
ברירת מחדלfalse
שדהnסוגintegerדרישהרשותערכים ומגבלות
⁦1⁩
ברירת מחדל—
שדהsizeסוגstringדרישהרשותערכים ומגבלות
1024x1024
ברירת מחדל—
פרמטרים ומחזור חיים של השיטה
פרמטרמפרט
פרמטרcontent_typeמפרטapplication/json
פרמטרrequiredמפרטmodel, prompt
פרמטרoptionalמפרטstream, n, size
פרמטרmaterial_typesמפרטtext
פרמטרconditionsמפרטUse stream:false or omit stream. The complete buffered JSON result contains all generated images.

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.

מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.

מצב מהיר
לא צוין כאשר נבחר מצב מהיר
מצב Flex
לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי
לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורהטבלת תעריפיםכמות חזויהחיוב
תצורהתעריפי בסיס לטוקניםטבלת תעריפיםתעריף בסיסכמות חזויה—חיוב
קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים
פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים
קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהEstimated generation costטבלת תעריפים—כמות חזויהאומדן ליצירה אחתחיוב
קלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.32768 אומדן לפני היצירה

This estimate is not an additional charge or a fixed rate for the completed generation.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · Images

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.\n

קבלה ושמירה של תוצאות

Ailoot Ultra · Images

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-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.

כשצריך לבדוק את התגובה המקורית

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

כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

מזהי מודלים קשורים IDs

openai/dall-e-3, dall-e-3

", "method_identity": { "effective_request_model_id": "dall-e-3", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "dall-e-3", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|dall-e-3", "ordinal": 1, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } } ], "model_id": "openai/dall-e-3", "nativeProvenance": { "input_facts_canonical_sha256": "e621ed37663547a9b480846d2682d43bf86599765de3a40f59d99fb4e005de02", "input_html_sha256": "067172077fdfc563945ba43f16ce21acfedbc109a1eb3acdbfb595a9b50aa8cc", "private_audit_sha256": "f003994b2875c3a84517da792e5d6bb8a6118b8b94f3d91b4b1afbf2cb3a024e", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/he/openai-dall-e-3/", "description": "DALL·E 3 יוצר תמונות מתיאור סצנה כתוב. השתמשו במזהה המודל המדויק openai/dall-e-3 או בכינוי שלו dall-e-3 עם מתודת יצירת התמונות, ואז שמרו כל כתובת URL לתמונה שהוחזרה ואת התוצאה הנלווית. בקשת פתיחה מתועדת מפיקה תמונה אחת בגודל 1024x1024 מטקסט.", "locale": "he", "md_url": "https://ailoot.ai/models/he/openai-dall-e-3/index.md", "title": "OpenAI: DALL·E 3 — Ailoot", "url": "https://ailoot.ai/models/he/openai-dall-e-3/" }, "rawModel": { "about": "DALL·E 3 הוא מודל הטקסט לתמונה של OpenAI. השתמשו בתיאור כתוב כדי ליצור איור, קונספט לסצנה או כיוון חזותי לעיצוב. תארו ב-prompt את הנושא, הסביבה, הקומפוזיציה, התאורה והעיבוד. למשל, תיאור קונספט יכול לבקש אופני משלוחים לצד חנות קטנה בשעת דמדומים, במבט מהרחוב, עם נושא ברור בקדמת התמונה ופלטת צבעים מאופקת.\n\nשלחו POST /v1/images/generations עם גוף application/json. מזהה המודל הציבורי המדויק הוא openai/dall-e-3; הכינוי המורשה dall-e-3 בוחר באותו כרטיס מודל. מבנה הפתיחה המתועד מספק model, prompt, n:1 ו-size:\"1024x1024\". n הוא מספר שלם אופציונלי וברירת המחדל שלו היא 1. שלחו stream:false, או השמיטו את stream, לקבלת תוצאת JSON מלאה. השתמשו ב-prompt טקסטואלי שאינו ריק ושמרו על הבקשה ממוקדת בתיאור תמונה שלם אחד. המתודה המוצעת היא יצירת תמונות מטקסט.\n\nנסחו במפורש את הדרישות החשובות למיקום התמונה. איור לכתבה יכול לציין את הרעיון המרכזי ואת העצמים המבטאים אותו. קונספט לסצנה יכול להגדיר את מיקום המצלמה, השעה ביום ואילו חלקים בקומפוזיציה צריכים מרחב סביבם. הפרידו נוסח מדויק שחייב להופיע בתמונה מתיאורי הסצנה, ואז בדקו את הכיתוב שנוצר ואת הסידור החזותי לפני השימוש בתוצאה הנבחרת.\n\nתגובת היצירה היא JSON עם חותמת זמן created ומערך data. פריט התוצאה המתועד כולל url ועשוי לכלול revised_prompt, prompt_filter_results ו-content_filter_results. שימרו את השדות האלה עם התגובה המלאה, והורידו את התמונה מכל כתובת URL חתומה של Ailoot שהוחזרה. קישורי קבצים חתומים של Ailoot תקפים ל-24 שעות ממועד הנפקתם. שמרו את כתובת ה-URL המדויקת שהוחזרה, כולל מחרוזת השאילתה שלה, עד שהקובץ נשמר; קבעו את פורמט התמונה שנשמרה מתוך התגובה בפועל או בתי הקובץ.\n\nהתייחסו לקובץ התמונה שהוחזר כנכס העיצוב השימושי ול-JSON כרשומת היצירה הנלווית שלו. בדקו את התמונה מול התיאור שסופק לפני שילובה בעמוד, במצגת או ביישום. אם התגובה חלקית או שתוצאת השליחה אינה ודאית, שימרו את מזהה הבקשה המקורי ואת המידע שהוחזר בעת בדיקת הניסיון הקיים, במקום ליצור תמונה נוספת רק כדי לשחזר תוצאה חסרה. לשליפת תוצאות שנשמרו, השתמשו באותו מפתח API לביצוע GET /v1/media/assets?family=image ועקבו אחר כל next_cursor. מזהה הנכס מופיע בכל כתובת URL שהוחזרה מסוג /v1/media/assets/{asset_id}/content וברשומת ספריית המדיה שלו. קראו GET /v1/media/assets/{asset_id} לכל רשומה שנבחרה והורידו את content_url המדויק שלה. אם בקשת הקובץ מחזירה 404 עם הקוד link_expired, קראו שוב את אותו נכס לקבלת קישור מעודכן. רענון קישור נכס אינו דורש בקשת יצירת תמונה נוספת.", "alias_of": null, "aliases": [ "dall-e-3" ], "author": "OpenAI", "ctx": null, "formats": [ "images" ], "id": "openai/dall-e-3", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "openai/dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "openai/dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "openai/dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "openai/dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] }, { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response, all actual results, original identifiers, usage and response headers.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "example_body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "outputs": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" }, "parameters": [ { "default_known": false, "enum": [ "dall-e-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" }, { "default_known": false, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "default_known": false, "enum": [ "1024x1024" ], "enum_known": true, "name": "size", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "model": { "enum": [ "dall-e-3" ], "type": "string" }, "n": { "enum": [ 1 ], "type": "integer" }, "prompt": { "type": "string" }, "size": { "enum": [ "1024x1024" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "dall-e-3", "n": 1, "prompt": "A calm studio product photograph with a plain background.", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Use stream:false or omit stream. The complete buffered JSON result contains all generated images." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "stream", "n", "size" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets", "query": { "cursor": "actual returned next_cursor, when present", "family": "image" } }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned content_url. Refresh an expired link by reading the same existing asset." }, "status": [], "unknown": "Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.", "family": "image", "format": "JSON with all URL or base64 outputs" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "cache_read_price": null, "cache_write_1h_price": null, "cache_write_price": null, "fast_multiplier": null, "flex_multiplier": null, "image_input_price": null, "image_output_price": null, "input_price": null, "intervals": null, "max_reasoning_effort_multiplier": null, "output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "request_model_id": "dall-e-3", "route_label": "Ultra", "status_reads": [], "tiers": [], "unit": "image", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.32768", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.32768", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "openai/dall-e-3", "request_model_id": "openai/dall-e-3", "route_label": "Ultra" }, { "canonical_model_id": "openai/dall-e-3", "request_model_id": "dall-e-3", "route_label": "Ultra" } ], "name": "OpenAI: DALL·E 3", "price": { "in": null, "in_label": null, "out": null, "out_label": null, "sort_in": null, "sort_out": null, "varies": true }, "short": "DALL·E 3 יוצר תמונות מתיאור סצנה כתוב. השתמשו במזהה המודל המדויק openai/dall-e-3 או בכינוי שלו dall-e-3 עם מתודת יצירת התמונות, ואז שמרו כל כתובת URL לתמונה שהוחזרה ואת התוצאה הנלווית. בקשת פתיחה מתועדת מפיקה תמונה אחת בגודל 1024x1024 מטקסט." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 }, { "contract_json_pointer": "/methods/1/rawMethod/contract", "html_json_pointer": "/methods/1/html", "method_ordinal": 1 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod", "/methods/1/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "DALL·E 3 יוצר תמונות מתיאור סצנה כתוב. השתמשו במזהה המודל המדויק openai/dall-e-3 או בכינוי שלו dall-e-3 עם מתודת יצירת התמונות, ואז שמרו כל כתובת URL לתמונה שהוחזרה ואת התוצאה הנלווית. בקשת פתיחה מתועדת מפיקה תמונה אחת בגודל 1024x1024 מטקסט.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "98d966b6bce072215e5610cecf600fdf7b3a646c401e9481501af0a99eebb23b", "renderer_sha256": "c36bd89b8b0dac234af52bf68530df83530b908ec7a9f2e1de2483fe236ae910" }, "sourceRevision": "4665d88c01bef93ad26f581e91605dc533bd1456fdf5f626efa976c7d477af6b" }