{ "aboutHtml": "

תמונה ממשימה מפורטת

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

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

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

שלוש צורות פריים וכוונון איכות

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

רמות האיכות הן low, medium, high ו־auto. בחירת האיכות משפיעה על היקף העיבוד ועל פירוט התוצאה. איכות וגודל הם הגדרות שונות: כיוון הפריים קובע את מרחב הקומפוזיציה, ורמת האיכות את מצב יצירתה. הרמות xhigh ו־max לא הוצהרו ל־GPT Image 1.5.

פורמט קובץ ורקע

כברירת מחדל התוצאה נוצרת ב־PNG; זמינים גם JPEG ו־WebP. ל־JPEG ול־WebP אפשר לקבוע את מידת הדחיסה. זו הגדרה של קובץ התוצאה, ששונה מאיכות היצירה.

אצל היצרן זמינים רקע שקוף ואטום, וכן בחירה אוטומטית. לשקיפות צריך PNG או WebP: JPEG אינו שומר ערוץ אלפא. רקע שקוף נוח כשהתמונה צריכה לשמש אובייקט נפרד בקומפוזיציה בהמשך. צריך להתאים את התמיכה בפרמטרים מסוימים לשיטה שנבחרה.

הטקסט והקומפוזיציה דורשים בדיקה

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

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

", "aboutText": "### תמונה ממשימה מפורטת\n\nGPT Image 1.5 הוא מודל של OpenAI ליצירת תמונות מתיאור טקסטואלי. היצרן מדגיש ציות להוראות ועיבוד משימה מפורטת: אפשר לקבוע בה את תוכן הסצנה, הקומפוזיציה, מראה העצמים והסגנון הרצוי. התוצאה של שיטת התמונות היא תמונה מוכנה.\n\nב־Ailoot כרטיס זה מתייחס ליצירה עם קלט טקסטואלי. OpenAI מתארת גם את עבודת המודל עם תמונות מקור, עריכה ושינוי אזורים נפרדים. היכולות האלה דורשות תמיכה נפרדת בקלט חזותי ואינן כלולות בדרך היצירה הטקסטואלית שמוצגת כאן.\n\nבפעולת העריכה הנפרדת שמספקת OpenAI המסכה משמשת מקור מנחה: לא מובטחת התאמה מדויקת של התוצאה לקווי המתאר שלה. לפעולה כזו דרושה תמיכה במסירת תמונת מקור; כרטיס Ailoot הנוכחי עדיין מתייחס ליצירה עם קלט טקסטואלי.\n\n### שלוש צורות פריים וכוונון איכות\n\nזמינים גודל ריבועי `1024x1024`, אופקי `1536x1024` ואנכי `1024x1536`, וכן בחירה אוטומטית. אין להחיל על גרסה זו ממדים שרירותיים של מודלים אחרים.\n\nרמות האיכות הן `low`, `medium`, `high` ו־`auto`. בחירת האיכות משפיעה על היקף העיבוד ועל פירוט התוצאה. איכות וגודל הם הגדרות שונות: כיוון הפריים קובע את מרחב הקומפוזיציה, ורמת האיכות את מצב יצירתה. הרמות `xhigh` ו־`max` לא הוצהרו ל־GPT Image 1.5.\n\n### פורמט קובץ ורקע\n\nכברירת מחדל התוצאה נוצרת ב־PNG; זמינים גם JPEG ו־WebP. ל־JPEG ול־WebP אפשר לקבוע את מידת הדחיסה. זו הגדרה של קובץ התוצאה, ששונה מאיכות היצירה.\n\nאצל היצרן זמינים רקע שקוף ואטום, וכן בחירה אוטומטית. לשקיפות צריך PNG או WebP: JPEG אינו שומר ערוץ אלפא. רקע שקוף נוח כשהתמונה צריכה לשמש אובייקט נפרד בקומפוזיציה בהמשך. צריך להתאים את התמיכה בפרמטרים מסוימים לשיטה שנבחרה.\n\n### הטקסט והקומפוזיציה דורשים בדיקה\n\nהמודל יכול לכלול כיתובים בתמונה ולהרכיב סצנה מכמה אלמנטים, אך לא מובטח מיקום מדויק של הטקסט והעצמים. גם שחזור המראה של אותה דמות או של העיצוב בין יצירות נפרדות דורש בקרה.\n\nיצירת תמונה מורכבת עשויה לקחת יותר זמן מפשוטה; לפי OpenAI, משימות מורכבות מסוימות עשויות לקחת עד שתי דקות. לתוצאה חשובים גם שלמות התיאור המקורי וגם בדיקת התמונה המוכנה: קריאות הכיתובים, מיקום הפרטים וההתאמה לסצנה שנקבעה מוערכים לפי הקובץ עצמו.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b461e59107492eae95d2b6eec453ced89bb70816089f68d26c8be559319b189b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "

O

GPT Image 1.5

OpenAI /gpt-image-1.5

התחלה

GPT Image 1.5 יוצר תמונות ממשימה טקסטואלית עם דגש על ציות להוראות מפורטות. זמינים שלושה סוגי פריים, כמה רמות איכות ופורמטים של תוצאה.

סוגי קלט נתמכים: טקסט
תוצאות: תמונות

על המודל

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

תמונה ממשימה מפורטת

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

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

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

שלוש צורות פריים וכוונון איכות

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

רמות האיכות הן low, medium, high ו־auto. בחירת האיכות משפיעה על היקף העיבוד ועל פירוט התוצאה. איכות וגודל הם הגדרות שונות: כיוון הפריים קובע את מרחב הקומפוזיציה, ורמת האיכות את מצב יצירתה. הרמות xhigh ו־max לא הוצהרו ל־GPT Image 1.5.

פורמט קובץ ורקע

כברירת מחדל התוצאה נוצרת ב־PNG; זמינים גם JPEG ו־WebP. ל־JPEG ול־WebP אפשר לקבוע את מידת הדחיסה. זו הגדרה של קובץ התוצאה, ששונה מאיכות היצירה.

אצל היצרן זמינים רקע שקוף ואטום, וכן בחירה אוטומטית. לשקיפות צריך PNG או WebP: JPEG אינו שומר ערוץ אלפא. רקע שקוף נוח כשהתמונה צריכה לשמש אובייקט נפרד בקומפוזיציה בהמשך. צריך להתאים את התמיכה בפרמטרים מסוימים לשיטה שנבחרה.

הטקסט והקומפוזיציה דורשים בדיקה

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

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

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

Ailoot · תמונות POST /v1/images/generations

סוגי קלט: text
סוגי פלט: image
פורמט פלט: קובץ תמונה

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות gpt-image-1.5	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩	ברירת מחדל⁦1⁩
שדה`response_format`	סוג`string`	דרישהרשות	ערכים ומגבלות url, b64_json	ברירת מחדל—
שדה`stream`	סוג`boolean`	דרישהרשות	ערכים ומגבלות	ברירת מחדלfalse
שדה`size`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`quality`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`background`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`output_format`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`output_compression`	סוג`integer`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`moderation`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`input_fidelity`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`style`	סוג`string`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—
שדה`partial_images`	סוג`integer`	דרישהרשות	ערכים ומגבלות תלוי במודל	ברירת מחדל—

שילובים של חומרי קלט

מטקסט לתמונה · נדרש: prompt

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`material_types`	מפרטtext
פרמטר`required`	מפרטmodel, prompt
פרמטר`optional_controls`	מפרטnull
פרמטר`content_type`	מפרטapplication/json

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.

תעריפים

תעריפי שיטות Ailoot

Ailoot תמונותPOST /v1/images/generations

קלט טקסט: ⁦‏0.005 ‏$⁩ / 1K
פלט טקסט: ⁦‏0.01 ‏$⁩ / 1K
קלט, תמונה: ⁦‏0.008 ‏$⁩ / 1K tokens
פלט, תמונה: ⁦‏0.032 ‏$⁩ / 1K tokens

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

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

Ailoot · תמונות

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-1.5", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

from openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-1.5', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-1.5", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

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

Ailoot · תמונות

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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

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

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

שמרו כל פריט נתונים. פענחו כל b64_json או הורידו את התוכן מכל URL חתום שהוחזר. בחרו סיומת קובץ לפי סוג ה־MIME/הבתים בפועל.

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

אם תוצאה של יצירת תמונה או עריכתה דורשת בדיקה, שמרו את operation_id/X-Client-Request-ID המקורי ואת פרטי התוצאה שהוחזרו. שחזרו תוצאות קיימות שבבעלותכם דרך ספריית המדיה באמצעות ערכי task_id או asset_id בפועל. אל תשלחו שוב את בקשת היצירה/העריכה ואל תבנו URL לתשאול סטטוס מתוך operation_id.

שדות התגובה

שדה	סוג
שדה`created`	סוגinteger
שדה`data[].url`	סוגstring
שדה`data[].b64_json`	סוגbase64 string
שדה`usage`	סוגobject

שגיאות והשלבים הבאים

תגובה	תנאי	השלב הבא
תגובה⁦400⁩ · `invalid_request_error`	תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים	השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה.
תגובה`server_error`	תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה	השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה.

כינויים

כינויים למודל

Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5

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

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

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

gpt-image-1.5, gpt-image-1.5

", "method_identity": { "effective_request_model_id": "gpt-image-1.5", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-1.5", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|gpt-image-1.5", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "שדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים", "http_status": 400, "recovery": "תקנו את השדות שצוינו לפני בקשת יצירה חדשה.", "type": "invalid_request_error" }, { "code": null, "condition": "התשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה", "http_status": null, "recovery": "שמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "אם תוצאה של יצירת תמונה או עריכתה דורשת בדיקה, שמרו את operation_id/X-Client-Request-ID המקורי ואת פרטי התוצאה שהוחזרו. שחזרו תוצאות קיימות שבבעלותכם דרך ספריית המדיה באמצעות ערכי task_id או asset_id בפועל. אל תשלחו שוב את בקשת היצירה/העריכה ואל תבנו URL לתשאול סטטוס מתוך operation_id." }, "material_combinations": [ { "content_types": [ "application/json", "multipart/form-data" ], "file_id_supported": false, "mode": "text_to_image", "multipart_part_read_limit_bytes": 20971520, "optional_mask": { "json": "mask.image_url", "multipart": "mask" }, "reference_representations": { "json": "images[].image_url", "multipart": [ "image", "image[]", "image[index]" ] }, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "שמרו כל פריט נתונים. פענחו כל b64_json או הורידו את התוכן מכל URL חתום שהוחזר. בחרו סיומת קובץ לפי סוג ה־MIME/הבתים בפועל.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "gpt-image-1.5" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "quality", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "background", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_format", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_compression", "required": false, "type": "integer" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "moderation", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_fidelity", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "style", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id" ] }, "hints": [ "מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "ערך task_id שהוחזר בפועל או רשומה בספריית המדיה", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: \"${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}\"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"gpt-image-1.5\", \"prompt\": \"\"}')\nf=Path(os.environ[\"AILOOT_PROMPT_FILE\"])\nif not f.is_file():raise SystemExit(\"Choose your actual UTF-8 brief\")\np['prompt']=f.read_text(encoding=\"utf-8\")\nif not p['prompt'].strip():raise SystemExit(\"Brief must contain text\")\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"O

GPT Image 1.5

OpenAI /gpt-image-1.5

התחלה

GPT Image 1.5 יוצר תמונות ממשימה טקסטואלית עם דגש על ציות להוראות מפורטות. זמינים שלושה סוגי פריים, כמה רמות איכות ופורמטים של תוצאה.

סוגי קלט נתמכים: טקסט
תוצאות: תמונות

על המודל

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

תמונה ממשימה מפורטת

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

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

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

שלוש צורות פריים וכוונון איכות

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

רמות האיכות הן low, medium, high ו־auto. בחירת האיכות משפיעה על היקף העיבוד ועל פירוט התוצאה. איכות וגודל הם הגדרות שונות: כיוון הפריים קובע את מרחב הקומפוזיציה, ורמת האיכות את מצב יצירתה. הרמות xhigh ו־max לא הוצהרו ל־GPT Image 1.5.

פורמט קובץ ורקע

כברירת מחדל התוצאה נוצרת ב־PNG; זמינים גם JPEG ו־WebP. ל־JPEG ול־WebP אפשר לקבוע את מידת הדחיסה. זו הגדרה של קובץ התוצאה, ששונה מאיכות היצירה.

אצל היצרן זמינים רקע שקוף ואטום, וכן בחירה אוטומטית. לשקיפות צריך PNG או WebP: JPEG אינו שומר ערוץ אלפא. רקע שקוף נוח כשהתמונה צריכה לשמש אובייקט נפרד בקומפוזיציה בהמשך. צריך להתאים את התמיכה בפרמטרים מסוימים לשיטה שנבחרה.

הטקסט והקומפוזיציה דורשים בדיקה

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

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

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

Ailoot Ultra · תמונות POST /v1/images/generations

סוגי קלט: text
סוגי פלט: image

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות gpt-image-1.5	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מרבי: ⁦32,000⁩	ברירת מחדל—
שדה`size`	סוג`string`	דרישהרשות	ערכים ומגבלות 1024x1024, 1536x1024, 1024x1536, auto	ברירת מחדלauto
שדה`background`	סוג`string`	דרישהרשות	ערכים ומגבלות transparent, opaque, auto	ברירת מחדלauto
שדה`moderation`	סוג`string`	דרישהרשות	ערכים ומגבלות low, auto תנאים: יש להשתמש ב־auto לבדיקת תוכן רגילה.	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦10⁩	ברירת מחדל⁦1⁩
שדה`quality`	סוג`string`	דרישהרשות	ערכים ומגבלות auto, high, medium, low	ברירת מחדלauto
שדה`output_compression`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦0⁩ מקסימום: ⁦100⁩ תנאים: חל על פלט JPEG ו־WebP; יש לשלוח את הערך השלם המתועד.	ברירת מחדל⁦100⁩
שדה`output_format`	סוג`string`	דרישהרשות	ערכים ומגבלות webp, png, jpeg	ברירת מחדלpng
שדה`stream`	סוג`boolean`	דרישהרשות	ערכים ומגבלות false תנאים: הנתיב הזה מחזיר תגובת JSON שלמה אחת.	ברירת מחדלfalse

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטprompt, model
פרמטר`material_types`	מפרטtext
פרמטר`optional`	מפרטsize, background, moderation, n, quality, output_compression, output_format, stream
פרמטר`conditions`	מפרטרקע שקוף מחייב PNG או WebP., דחיסת הפלט חלה על JPEG או WebP., השיטה שנבחרה יוצרת מטקסט. אפשרויות העריכה וההזרמה המתוארות אצל היצרן הן יכולות נפרדות.

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

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

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

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

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

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

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

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

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

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

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

Ailoot Ultra · תמונות

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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1.5', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

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

Ailoot Ultra · תמונות

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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

קריאות תוכן נוספות

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n

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

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

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

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

שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.

שדות התגובה

שדה	סוג
שדה`created`	סוג
שדה`data[].url`	סוג
שדה`data[].b64_json`	סוג
שדה`usage`	סוג

כינויים

כינויים למודל

Ailoot gpt-image-1.5
Ailoot Ultra gpt-image-1.5

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

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

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

gpt-image-1.5, gpt-image-1.5

", "method_identity": { "effective_request_model_id": "gpt-image-1.5", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-1.5", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|gpt-image-1.5", "ordinal": 1, "rawMethod": { "billing_basis": { "basis": "original_invoice_usd", "description": "התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.", "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 and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה." }, "outputs": { "all_results": "שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "gpt-image-1.5" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "maxLength": 32000, "maximum_length": 32000, "name": "prompt", "required": true, "type": "string" }, { "default": "auto", "default_known": true, "enum": [ "1024x1024", "1536x1024", "1024x1536", "auto" ], "enum_known": true, "name": "size", "required": false, "type": "string" }, { "default": "auto", "default_known": true, "enum": [ "transparent", "opaque", "auto" ], "enum_known": true, "name": "background", "required": false, "type": "string" }, { "conditions": "יש להשתמש ב־auto לבדיקת תוכן רגילה.", "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "enum_known": true, "name": "moderation", "required": false, "type": "string" }, { "default": 1, "default_known": true, "maximum": 10, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "default": "auto", "default_known": true, "enum": [ "auto", "high", "medium", "low" ], "enum_known": true, "name": "quality", "required": false, "type": "string" }, { "conditions": "חל על פלט JPEG ו־WebP; יש לשלוח את הערך השלם המתועד.", "default": 100, "default_known": true, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "name": "output_compression", "required": false, "type": "integer" }, { "default": "png", "default_known": true, "enum": [ "webp", "png", "jpeg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "הנתיב הזה מחזיר תגובת JSON שלמה אחת.", "default": false, "default_known": true, "description": "This route returns one completed JSON response.", "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "request_schema": { "properties": { "background": { "default": "auto", "enum": [ "transparent", "opaque", "auto" ], "type": "string" }, "model": { "enum": [ "gpt-image-1.5" ], "type": "string" }, "moderation": { "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "type": "string" }, "n": { "default": 1, "maximum": 10, "minimum": 1, "type": "integer" }, "output_compression": { "default": 100, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "type": "integer" }, "output_format": { "default": "png", "enum": [ "webp", "png", "jpeg" ], "type": "string" }, "prompt": { "maxLength": 32000, "type": "string" }, "quality": { "default": "auto", "enum": [ "auto", "high", "medium", "low" ], "type": "string" }, "size": { "default": "auto", "enum": [ "1024x1024", "1536x1024", "1024x1536", "auto" ], "type": "string" }, "stream": { "default": false, "description": "This route returns one completed JSON response.", "enum": [ false ], "type": "boolean" } }, "required": [ "prompt", "model" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "background": "auto", "model": "gpt-image-1.5", "moderation": "auto", "n": 1, "output_format": "png", "prompt": "A cute baby sea otter", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "רקע שקוף מחייב PNG או WebP.", "דחיסת הפלט חלה על JPEG או WebP.", "השיטה שנבחרה יוצרת מטקסט. אפשרויות העריכה וההזרמה המתוארות אצל היצרן הן יכולות נפרדות." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "size", "background", "moderation", "n", "quality", "output_compression", "output_format", "stream" ], "required": [ "prompt", "model" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "ערך task_id שהוחזר בפועל או רשומה בספריית המדיה", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "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": "אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "עלות יצירה משוערת", "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": "out", "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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1.5', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"