Wan2.7-Image-Pro הוא מודל של Alibaba ליצירת תמונות מטקסט. הכרטיס הנוכחי של Ailoot מפרסם קלט טקסטואלי ותוצאה בצורת תמונה. היצרן מספק גם עריכה, איחוד תמונות ייחוס ושינויים מקומיים; הדרכים האלה דורשות תמיכה נפרדת בתמונות קלט ואינן מוצגות בשיטה הנוכחית של הכרטיס.
במצב עם תמונות ייחוס אצל היצרן אפשר למסור עד תשע תמונות מקור ולתאר אילו אלמנטים מכל אחת יש להשתמש בהם. בעריכה המודל שומר על האובייקט המרכזי, משנה פרטים נבחרים או מרכיב קומפוזיציה חדשה מכמה חומרים. כדי לכוון את השינויים באופן מדויק יותר, אפשר לסמן עד שני אזורים מלבניים בתמונת קלט אחת.
מחוץ לסדרות רציפות אפשר להגדיר פלטה של 3–10 צבעים. מצב ההסקה מיועד ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה: המודל מנתח מראש את תיאור הסצנה.
במפרט Alibaba פלט רגיל כולל תמונה אחת עד ארבע תמונות. בסדרה עלילתית אפשר לקבוע מגבלה עליונה של עד 12; את המספר בפועל המודל בוחר לפי המשימה. הסדרה יכולה להביא בחשבון טקסט ותמונות ייחוס לשמירת מאפיינים משותפים של דמויות ולהתפתחות עקבית של הסיפור. פלטה והסקה אינן מופעלות במצב זה.
רמת 4K נתמכת ביצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה. עריכה לפי תמונות וסדרות רציפות מוגבלות לרמת 2K. הסימונים האלה קובעים את שטח הפיקסלים, ולא אורך זהה של כל צלע. אפשר לבחור פורמט פריים מ־1:8 עד 8:1; בעריכה עם רזולוציה שנקבעה מראש יחס הרוחב־גובה נקבע לפי תמונת הייחוס האחרונה. התוצאות נשמרות ב־PNG.
לדרכים עם תמונות קלט Alibaba מאפשרת JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. המגבלות הן 20 מגה־בייט לקובץ, בין 240 ל־8000 פיקסלים בכל צלע ויחס מ־1:8 עד 8:1. למשימה הטקסטואלית נתמכות סינית ואנגלית; המגבלה היא 5000 תווים, והחלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבת המשימה. זרע האקראיות הראשוני מסייע לשמור על דמיון בין גרסאות, אך אינו מבטיח שחזור מדויק.
", "aboutText": "Wan2.7-Image-Pro הוא מודל של Alibaba ליצירת תמונות מטקסט. הכרטיס הנוכחי של Ailoot מפרסם קלט טקסטואלי ותוצאה בצורת תמונה. היצרן מספק גם עריכה, איחוד תמונות ייחוס ושינויים מקומיים; הדרכים האלה דורשות תמיכה נפרדת בתמונות קלט ואינן מוצגות בשיטה הנוכחית של הכרטיס.\n\nבמצב עם תמונות ייחוס אצל היצרן אפשר למסור עד תשע תמונות מקור ולתאר אילו אלמנטים מכל אחת יש להשתמש בהם. בעריכה המודל שומר על האובייקט המרכזי, משנה פרטים נבחרים או מרכיב קומפוזיציה חדשה מכמה חומרים. כדי לכוון את השינויים באופן מדויק יותר, אפשר לסמן עד שני אזורים מלבניים בתמונת קלט אחת.\n\n### פלטה ומשימה מורכבת\n\nמחוץ לסדרות רציפות אפשר להגדיר פלטה של 3–10 צבעים. מצב ההסקה מיועד ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה: המודל מנתח מראש את תיאור הסצנה.\n\nבמפרט Alibaba פלט רגיל כולל תמונה אחת עד ארבע תמונות. בסדרה עלילתית אפשר לקבוע מגבלה עליונה של עד 12; את המספר בפועל המודל בוחר לפי המשימה. הסדרה יכולה להביא בחשבון טקסט ותמונות ייחוס לשמירת מאפיינים משותפים של דמויות ולהתפתחות עקבית של הסיפור. פלטה והסקה אינן מופעלות במצב זה.\n\n### הרזולוציה תלויה במצב\n\nרמת 4K נתמכת ביצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה. עריכה לפי תמונות וסדרות רציפות מוגבלות לרמת 2K. הסימונים האלה קובעים את שטח הפיקסלים, ולא אורך זהה של כל צלע. אפשר לבחור פורמט פריים מ־1:8 עד 8:1; בעריכה עם רזולוציה שנקבעה מראש יחס הרוחב־גובה נקבע לפי תמונת הייחוס האחרונה. התוצאות נשמרות ב־PNG.\n\nלדרכים עם תמונות קלט Alibaba מאפשרת JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. המגבלות הן 20 מגה־בייט לקובץ, בין 240 ל־8000 פיקסלים בכל צלע ויחס מ־1:8 עד 8:1. למשימה הטקסטואלית נתמכות סינית ואנגלית; המגבלה היא 5000 תווים, והחלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבת המשימה. זרע האקראיות הראשוני מסייע לשמור על דמיון בין גרסאות, אך אינו מבטיח שחזור מדויק.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a4e16d34e98243e693c5ac29149e2b2922d0429c0af638d5ff04ac93f2e16ce0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "wan2.7-image-proמודל ליצירת תמונות ממשימה טקסטואלית. היצרן מספק שליטה בפלטת הצבעים ורזולוציה של עד 4K ביצירה רגילה מטקסט.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Wan2.7-Image-Pro הוא מודל של Alibaba ליצירת תמונות מטקסט. הכרטיס הנוכחי של Ailoot מפרסם קלט טקסטואלי ותוצאה בצורת תמונה. היצרן מספק גם עריכה, איחוד תמונות ייחוס ושינויים מקומיים; הדרכים האלה דורשות תמיכה נפרדת בתמונות קלט ואינן מוצגות בשיטה הנוכחית של הכרטיס.
במצב עם תמונות ייחוס אצל היצרן אפשר למסור עד תשע תמונות מקור ולתאר אילו אלמנטים מכל אחת יש להשתמש בהם. בעריכה המודל שומר על האובייקט המרכזי, משנה פרטים נבחרים או מרכיב קומפוזיציה חדשה מכמה חומרים. כדי לכוון את השינויים באופן מדויק יותר, אפשר לסמן עד שני אזורים מלבניים בתמונת קלט אחת.
מחוץ לסדרות רציפות אפשר להגדיר פלטה של 3–10 צבעים. מצב ההסקה מיועד ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה: המודל מנתח מראש את תיאור הסצנה.
במפרט Alibaba פלט רגיל כולל תמונה אחת עד ארבע תמונות. בסדרה עלילתית אפשר לקבוע מגבלה עליונה של עד 12; את המספר בפועל המודל בוחר לפי המשימה. הסדרה יכולה להביא בחשבון טקסט ותמונות ייחוס לשמירת מאפיינים משותפים של דמויות ולהתפתחות עקבית של הסיפור. פלטה והסקה אינן מופעלות במצב זה.
רמת 4K נתמכת ביצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה. עריכה לפי תמונות וסדרות רציפות מוגבלות לרמת 2K. הסימונים האלה קובעים את שטח הפיקסלים, ולא אורך זהה של כל צלע. אפשר לבחור פורמט פריים מ־1:8 עד 8:1; בעריכה עם רזולוציה שנקבעה מראש יחס הרוחב־גובה נקבע לפי תמונת הייחוס האחרונה. התוצאות נשמרות ב־PNG.
לדרכים עם תמונות קלט Alibaba מאפשרת JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. המגבלות הן 20 מגה־בייט לקובץ, בין 240 ל־8000 פיקסלים בכל צלע ויחס מ־1:8 עד 8:1. למשימה הטקסטואלית נתמכות סינית ואנגלית; המגבלה היא 5000 תווים, והחלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבת המשימה. זרע האקראיות הראשוני מסייע לשמור על דמיון בין גרסאות, אך אינו מבטיח שחזור מדויק.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות wan2.7-image-pro | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 | ברירת מחדל1 |
שדהresponse_format | סוגstring | דרישהרשות | ערכים ומגבלות url, b64_json | ברירת מחדל— |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות | ברירת מחדלfalse |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהpartial_images | סוגinteger | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהimages[].image_url | סוגstring | דרישהלא נתמך | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg מספר תמונות מרבי במערך: 9 תנאים: כתובת URL ממשית אחת לכל אובייקט images[]. מספר הפריטים במערך נפרד מערך המחרוזת הזה. חל כאשר: רק JSON images/edits; הממשק JSON images/generations אינו מפענח הפניות images. | ברירת מחדל— |
שדהimage | סוגfile | דרישהרשות | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
שדהimage[] | סוגfile[] | דרישהרשות | ערכים ומגבלות מספר פריטים מרבי: 9 מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
מטקסט לתמונה · נדרש: prompt
reference_images_generation · נדרש: 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}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
POST /v1/images/generationsלפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהwan2.7-image-pro · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.16 $ לקריאה |
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": "wan2.7-image-pro", "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\nfrom 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': 'wan2.7-image-pro', '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])\nimport 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": "wan2.7-image-pro", "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הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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 wan2.7-image-pro, wan-image, wan-image-latest
השתמשו בנתיבי השיטות המוצגים למעלה.
wan-imageמודל ליצירת תמונות ממשימה טקסטואלית. היצרן מספק שליטה בפלטת הצבעים ורזולוציה של עד 4K ביצירה רגילה מטקסט.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Wan2.7-Image-Pro הוא מודל של Alibaba ליצירת תמונות מטקסט. הכרטיס הנוכחי של Ailoot מפרסם קלט טקסטואלי ותוצאה בצורת תמונה. היצרן מספק גם עריכה, איחוד תמונות ייחוס ושינויים מקומיים; הדרכים האלה דורשות תמיכה נפרדת בתמונות קלט ואינן מוצגות בשיטה הנוכחית של הכרטיס.
במצב עם תמונות ייחוס אצל היצרן אפשר למסור עד תשע תמונות מקור ולתאר אילו אלמנטים מכל אחת יש להשתמש בהם. בעריכה המודל שומר על האובייקט המרכזי, משנה פרטים נבחרים או מרכיב קומפוזיציה חדשה מכמה חומרים. כדי לכוון את השינויים באופן מדויק יותר, אפשר לסמן עד שני אזורים מלבניים בתמונת קלט אחת.
מחוץ לסדרות רציפות אפשר להגדיר פלטה של 3–10 צבעים. מצב ההסקה מיועד ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה: המודל מנתח מראש את תיאור הסצנה.
במפרט Alibaba פלט רגיל כולל תמונה אחת עד ארבע תמונות. בסדרה עלילתית אפשר לקבוע מגבלה עליונה של עד 12; את המספר בפועל המודל בוחר לפי המשימה. הסדרה יכולה להביא בחשבון טקסט ותמונות ייחוס לשמירת מאפיינים משותפים של דמויות ולהתפתחות עקבית של הסיפור. פלטה והסקה אינן מופעלות במצב זה.
רמת 4K נתמכת ביצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה. עריכה לפי תמונות וסדרות רציפות מוגבלות לרמת 2K. הסימונים האלה קובעים את שטח הפיקסלים, ולא אורך זהה של כל צלע. אפשר לבחור פורמט פריים מ־1:8 עד 8:1; בעריכה עם רזולוציה שנקבעה מראש יחס הרוחב־גובה נקבע לפי תמונת הייחוס האחרונה. התוצאות נשמרות ב־PNG.
לדרכים עם תמונות קלט Alibaba מאפשרת JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. המגבלות הן 20 מגה־בייט לקובץ, בין 240 ל־8000 פיקסלים בכל צלע ויחס מ־1:8 עד 8:1. למשימה הטקסטואלית נתמכות סינית ואנגלית; המגבלה היא 5000 תווים, והחלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבת המשימה. זרע האקראיות הראשוני מסייע לשמור על דמיון בין גרסאות, אך אינו מבטיח שחזור מדויק.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות wan-image | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 | ברירת מחדל1 |
שדהresponse_format | סוגstring | דרישהרשות | ערכים ומגבלות url, b64_json | ברירת מחדל— |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות | ברירת מחדלfalse |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהpartial_images | סוגinteger | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהimages[].image_url | סוגstring | דרישהלא נתמך | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg מספר תמונות מרבי במערך: 9 תנאים: כתובת URL ממשית אחת לכל אובייקט images[]. מספר הפריטים במערך נפרד מערך המחרוזת הזה. חל כאשר: רק JSON images/edits; הממשק JSON images/generations אינו מפענח הפניות images. | ברירת מחדל— |
שדהimage | סוגfile | דרישהרשות | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
שדהimage[] | סוגfile[] | דרישהרשות | ערכים ומגבלות מספר פריטים מרבי: 9 מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
מטקסט לתמונה · נדרש: prompt
reference_images_generation · נדרש: 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}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
POST /v1/images/generationsלפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהwan2.7-image-pro · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.16 $ לקריאה |
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": "wan-image", "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\nfrom 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': 'wan-image', '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])\nimport 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": "wan-image", "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הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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 wan2.7-image-pro, wan-image, wan-image-latest
השתמשו בנתיבי השיטות המוצגים למעלה.
wan-image-latestמודל ליצירת תמונות ממשימה טקסטואלית. היצרן מספק שליטה בפלטת הצבעים ורזולוציה של עד 4K ביצירה רגילה מטקסט.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Wan2.7-Image-Pro הוא מודל של Alibaba ליצירת תמונות מטקסט. הכרטיס הנוכחי של Ailoot מפרסם קלט טקסטואלי ותוצאה בצורת תמונה. היצרן מספק גם עריכה, איחוד תמונות ייחוס ושינויים מקומיים; הדרכים האלה דורשות תמיכה נפרדת בתמונות קלט ואינן מוצגות בשיטה הנוכחית של הכרטיס.
במצב עם תמונות ייחוס אצל היצרן אפשר למסור עד תשע תמונות מקור ולתאר אילו אלמנטים מכל אחת יש להשתמש בהם. בעריכה המודל שומר על האובייקט המרכזי, משנה פרטים נבחרים או מרכיב קומפוזיציה חדשה מכמה חומרים. כדי לכוון את השינויים באופן מדויק יותר, אפשר לסמן עד שני אזורים מלבניים בתמונת קלט אחת.
מחוץ לסדרות רציפות אפשר להגדיר פלטה של 3–10 צבעים. מצב ההסקה מיועד ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה: המודל מנתח מראש את תיאור הסצנה.
במפרט Alibaba פלט רגיל כולל תמונה אחת עד ארבע תמונות. בסדרה עלילתית אפשר לקבוע מגבלה עליונה של עד 12; את המספר בפועל המודל בוחר לפי המשימה. הסדרה יכולה להביא בחשבון טקסט ותמונות ייחוס לשמירת מאפיינים משותפים של דמויות ולהתפתחות עקבית של הסיפור. פלטה והסקה אינן מופעלות במצב זה.
רמת 4K נתמכת ביצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה. עריכה לפי תמונות וסדרות רציפות מוגבלות לרמת 2K. הסימונים האלה קובעים את שטח הפיקסלים, ולא אורך זהה של כל צלע. אפשר לבחור פורמט פריים מ־1:8 עד 8:1; בעריכה עם רזולוציה שנקבעה מראש יחס הרוחב־גובה נקבע לפי תמונת הייחוס האחרונה. התוצאות נשמרות ב־PNG.
לדרכים עם תמונות קלט Alibaba מאפשרת JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. המגבלות הן 20 מגה־בייט לקובץ, בין 240 ל־8000 פיקסלים בכל צלע ויחס מ־1:8 עד 8:1. למשימה הטקסטואלית נתמכות סינית ואנגלית; המגבלה היא 5000 תווים, והחלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבת המשימה. זרע האקראיות הראשוני מסייע לשמור על דמיון בין גרסאות, אך אינו מבטיח שחזור מדויק.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות wan-image-latest | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 | ברירת מחדל1 |
שדהresponse_format | סוגstring | דרישהרשות | ערכים ומגבלות url, b64_json | ברירת מחדל— |
שדהstream | סוגboolean | דרישהרשות | ערכים ומגבלות | ברירת מחדלfalse |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהpartial_images | סוגinteger | דרישהרשות | ערכים ומגבלות תלוי במודל | ברירת מחדל— |
שדהimages[].image_url | סוגstring | דרישהלא נתמך | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg מספר תמונות מרבי במערך: 9 תנאים: כתובת URL ממשית אחת לכל אובייקט images[]. מספר הפריטים במערך נפרד מערך המחרוזת הזה. חל כאשר: רק JSON images/edits; הממשק JSON images/generations אינו מפענח הפניות images. | ברירת מחדל— |
שדהimage | סוגfile | דרישהרשות | ערכים ומגבלות מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
שדהimage[] | סוגfile[] | דרישהרשות | ערכים ומגבלות מספר פריטים מרבי: 9 מספר בייטים מרבי לאחר פענוח: 20,971,520 סוגי MIME: image/png, image/jpeg חל כאשר: יצירה באמצעות multipart/form-data | ברירת מחדל— |
מטקסט לתמונה · נדרש: prompt
reference_images_generation · נדרש: 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}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
POST /v1/images/generationsלפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהwan2.7-image-pro · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.16 $ לקריאה |
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": "wan-image-latest", "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\nfrom 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': 'wan-image-latest', '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])\nimport 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": "wan-image-latest", "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הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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 wan2.7-image-pro, wan-image, wan-image-latest
השתמשו בנתיבי השיטות המוצגים למעלה.