Wan2.7-Image יוצר תמונות ממשימה טקסטואלית. בכרטיס הנוכחי של Ailoot מוצגים דווקא קלט טקסטואלי ותוצאה בצורת תמונה. לפי Alibaba, גרסה זו מיועדת לקבלת חלופות במהירות רבה יותר. מפרט היצרן כולל גם עריכה, שילוב תמונות ייחוס ושינויים מקומיים; אלה דורשים תמיכה נפרדת בתמונות קלט, שאינה מוצגת בשיטה הנוכחית של הכרטיס.
למצב המבוסס על תמונות ייחוס Alibaba מספקת עד תשע תמונות מקור במשימה. הן משמשות בסיס למראה העצם, לקומפוזיציה ולפרטים. המודל יכול לשלב כמה חומרים בסצנה חדשה או לשנות את התמונה המקורית תוך שמירה על האובייקט המרכזי. לעריכה נקודתית זמינים אזורים מסומנים במפורש: אפשר לציין עד שני אזורים מלבניים בתמונה אחת.
במפרט Alibaba המצב הרגיל מפיק תוצאה אחת עד ארבע תוצאות. סדרה רציפה מאפשרת לבקש עד 12 תמונות הקשורות בסיפור או במאפיינים משותפים של הדמויות. זו מגבלה עליונה לסדרה: המודל קובע בעצמו את מספר הפריימים הדרוש ויכול להחזיר פחות. המשימה וחומרי המקור מסייעים לשמור על קו עלילה משותף.
ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה זמין מצב הסקה. בו המודל מנתח בפירוט רב יותר תיאור מורכב לפני יצירת התמונה. בעריכה לפי תמונות ובסדרה רציפה מצב זה אינו מופעל. פלטה מוגדרת של 3–10 צבעים זמינה מחוץ לסדרות רציפות.
במצבים עם תמונות מקור היצרן תומך ב־JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. כל צלע יכולה להכיל בין 240 ל־8000 פיקסלים, גודל הקובץ עד 20 מגה־בייט, ויחס הרוחב־גובה מ־1:8 עד 8:1.
המשימה הטקסטואלית תומכת בסינית ובאנגלית ומוגבלת ל־5000 תווים; החלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבה נוספת של המשימה.
פורמט הפלט הוא PNG, והרזולוציה עד רמת 2K. הסימון מתייחס לשטח הפיקסלים הכולל, ולא לאורך מרבי קבוע של צלע; אפשר לבחור צורה בטווח שבין 1:8 ל־8:1. בעריכה עם רזולוציה שנקבעה מראש, התוצאה שומרת על יחס הרוחב־גובה של תמונת הייחוס האחרונה. אותו זרע אקראיות ראשוני מסייע להפיק גרסאות דומות, אך אינו מבטיח התאמה מלאה.
", "aboutText": "Wan2.7-Image יוצר תמונות ממשימה טקסטואלית. בכרטיס הנוכחי של Ailoot מוצגים דווקא קלט טקסטואלי ותוצאה בצורת תמונה. לפי Alibaba, גרסה זו מיועדת לקבלת חלופות במהירות רבה יותר. מפרט היצרן כולל גם עריכה, שילוב תמונות ייחוס ושינויים מקומיים; אלה דורשים תמיכה נפרדת בתמונות קלט, שאינה מוצגת בשיטה הנוכחית של הכרטיס.\n\n### המצבים המתוארים בידי Alibaba\n\nלמצב המבוסס על תמונות ייחוס Alibaba מספקת עד תשע תמונות מקור במשימה. הן משמשות בסיס למראה העצם, לקומפוזיציה ולפרטים. המודל יכול לשלב כמה חומרים בסצנה חדשה או לשנות את התמונה המקורית תוך שמירה על האובייקט המרכזי. לעריכה נקודתית זמינים אזורים מסומנים במפורש: אפשר לציין עד שני אזורים מלבניים בתמונה אחת.\n\nבמפרט Alibaba המצב הרגיל מפיק תוצאה אחת עד ארבע תוצאות. סדרה רציפה מאפשרת לבקש עד 12 תמונות הקשורות בסיפור או במאפיינים משותפים של הדמויות. זו מגבלה עליונה לסדרה: המודל קובע בעצמו את מספר הפריימים הדרוש ויכול להחזיר פחות. המשימה וחומרי המקור מסייעים לשמור על קו עלילה משותף.\n\nליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה זמין מצב הסקה. בו המודל מנתח בפירוט רב יותר תיאור מורכב לפני יצירת התמונה. בעריכה לפי תמונות ובסדרה רציפה מצב זה אינו מופעל. פלטה מוגדרת של 3–10 צבעים זמינה מחוץ לסדרות רציפות.\n\n### הקלט והתוצאה\n\nבמצבים עם תמונות מקור היצרן תומך ב־JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. כל צלע יכולה להכיל בין 240 ל־8000 פיקסלים, גודל הקובץ עד 20 מגה־בייט, ויחס הרוחב־גובה מ־1:8 עד 8:1.\n\nהמשימה הטקסטואלית תומכת בסינית ובאנגלית ומוגבלת ל־5000 תווים; החלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבה נוספת של המשימה.\n\nפורמט הפלט הוא PNG, והרזולוציה עד רמת 2K. הסימון מתייחס לשטח הפיקסלים הכולל, ולא לאורך מרבי קבוע של צלע; אפשר לבחור צורה בטווח שבין 1:8 ל־8:1. בעריכה עם רזולוציה שנקבעה מראש, התוצאה שומרת על יחס הרוחב־גובה של תמונת הייחוס האחרונה. אותו זרע אקראיות ראשוני מסייע להפיק גרסאות דומות, אך אינו מבטיח התאמה מלאה.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "23f9ffb5c8fc59d3af86967e57da9dfa37f9084ae36615bb5c1955bba024f4c2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "wan2.7-imageמודל ליצירת תמונות מטקסט להכנת חלופות עיצוב ואיורים. לפי Alibaba, גרסה זו מיועדת ליצירה מהירה יותר של תמונות.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Wan2.7-Image יוצר תמונות ממשימה טקסטואלית. בכרטיס הנוכחי של Ailoot מוצגים דווקא קלט טקסטואלי ותוצאה בצורת תמונה. לפי Alibaba, גרסה זו מיועדת לקבלת חלופות במהירות רבה יותר. מפרט היצרן כולל גם עריכה, שילוב תמונות ייחוס ושינויים מקומיים; אלה דורשים תמיכה נפרדת בתמונות קלט, שאינה מוצגת בשיטה הנוכחית של הכרטיס.
למצב המבוסס על תמונות ייחוס Alibaba מספקת עד תשע תמונות מקור במשימה. הן משמשות בסיס למראה העצם, לקומפוזיציה ולפרטים. המודל יכול לשלב כמה חומרים בסצנה חדשה או לשנות את התמונה המקורית תוך שמירה על האובייקט המרכזי. לעריכה נקודתית זמינים אזורים מסומנים במפורש: אפשר לציין עד שני אזורים מלבניים בתמונה אחת.
במפרט Alibaba המצב הרגיל מפיק תוצאה אחת עד ארבע תוצאות. סדרה רציפה מאפשרת לבקש עד 12 תמונות הקשורות בסיפור או במאפיינים משותפים של הדמויות. זו מגבלה עליונה לסדרה: המודל קובע בעצמו את מספר הפריימים הדרוש ויכול להחזיר פחות. המשימה וחומרי המקור מסייעים לשמור על קו עלילה משותף.
ליצירה רגילה מטקסט ללא תמונות ייחוס וללא סדרה רציפה זמין מצב הסקה. בו המודל מנתח בפירוט רב יותר תיאור מורכב לפני יצירת התמונה. בעריכה לפי תמונות ובסדרה רציפה מצב זה אינו מופעל. פלטה מוגדרת של 3–10 צבעים זמינה מחוץ לסדרות רציפות.
במצבים עם תמונות מקור היצרן תומך ב־JPEG, JPG, PNG ללא שקיפות, BMP ו־WEBP. כל צלע יכולה להכיל בין 240 ל־8000 פיקסלים, גודל הקובץ עד 20 מגה־בייט, ויחס הרוחב־גובה מ־1:8 עד 8:1.
המשימה הטקסטואלית תומכת בסינית ובאנגלית ומוגבלת ל־5000 תווים; החלק העודף נחתך. גרסה זו אינה מספקת תיאור שלילי או הרחבה נוספת של המשימה.
פורמט הפלט הוא PNG, והרזולוציה עד רמת 2K. הסימון מתייחס לשטח הפיקסלים הכולל, ולא לאורך מרבי קבוע של צלע; אפשר לבחור צורה בטווח שבין 1:8 ל־8:1. בעריכה עם רזולוציה שנקבעה מראש, התוצאה שומרת על יחס הרוחב־גובה של תמונת הייחוס האחרונה. אותו זרע אקראיות ראשוני מסייע להפיק גרסאות דומות, אך אינו מבטיח התאמה מלאה.
POST /v1/images/generationstextimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות wan2.7-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 · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · קלט 0.00 $ לקריאה פלט · פלט 0.06 $ לקריאה |
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", "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', '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", "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
השתמשו בנתיבי השיטות המוצגים למעלה.