Recraft V4 הוא מודל הרסטר הרגיל בדור V4 של Recraft. היצרן מדגיש שיקול דעת עיצובי: קומפוזיציה מאוזנת, יחסי צבע מגובשים ופרטים שתומכים בכוונה החזותית. הוא יכול לעבוד עם איור מסוגנן, סצנות צילומיות וקונספטים לעיצוב גרפי. השתמשו בו כאשר הבריף דורש תמונה שמשלבת בחירות אסתטיות עם דיוק בהנחיה, בין אם חוקרים אווירה מכיוון קצר ובין אם מגדירים פריסה מכוונת בפירוט.
קוד המודל המדויק הוא recraftv4. תיעוד היצרן שלו מציין פלט רסטר ב־1K בפורמט WebP ללא אובדן או PNG. תמונה ריבועית היא 1024 × 1024 פיקסלים, 16:9 הוא 1344 × 768 ו־2:3 הוא 832 × 1280; יחסים נתמכים אחרים משתמשים בממדים משלהם. V4 Pro הוא מהדורת הרסטר הנפרדת ב־2K, ואילו V4 Vector ו־Pro Vector מחזירים SVG הניתן לעריכה. בחרו את וריאנט V4 המדויק לתוצר המיועד במקום לשלב את תכונות הפלט השונות האלה.
מדריך היצרן מבחין בין הנחיות פרשניות קצרות לבין כיוון יצירתי מובנה. ביטוי קצר יכול להשאיר מקום לחקר צורה, אווירה ומסגור. בריף מובנה יכול לנקוב בנושא, בסביבה, בתנוחה, בחומר, ברכיבים משניים, בתאורה ובהיררכיה חזותית. לאיור סיפורי, תארו רוכב אופניים שחוצה גשר קטן, צורות מפושטות נועזות, צבעים חמים מאופקים ותנועה ברורה משמאל לימין. החלטות התוכן והקומפוזיציה האלה מעשיות יותר מרשימה ארוכה של תארי סגנון שאינם קשורים.
הטווח של V4 כולל איור, דימויים בעלי נפח וחזות פוטוריאליסטית. המדריך ממליץ לתאר היגיון ציור לאיור וחומר, תאורה, מצלמה ועומק לתמונה במראה תלת־ממדי. האחרונה נשארת חזות רסטר ולא רשת גאומטרית הניתנת לעריכה. לכרזה או לקונספט אריזה, ציינו אילו מילים ראשיות, היכן הן שייכות וכיצד התמונה והטיפוגרפיה משתלבות. היצרן מדגיש טקסט קצר ובינוני קריא; בדקו את הניסוח ואת הסידור בפועל בתמונה שהוחזרה לפני שימוש בה.
היצירה תומכת בהנחיות של עד 10,000 תווים, בערך seed אקראי, באחד עד שישה פלטים, בצבעים מועדפים ובצבע רקע רצוי. סגנונות מותאמים תואמים ותמונות ייחוס אופציונליים יכולים להנחות את הטיפול החזותי באמצעות התאמה גמישה או מדויקת. בחרו ייחוס נקי או מערך השייך לעולם חזותי אחד, ואז תנו להנחיה לתאר את הנושא ואת הסצנה החדשים. התאמת צבע בין הייחוס לפלט אינה מובטחת, לכן הבהירו את הפלטה הנדרשת והשוו אליה את התוצאה. ליצירה בסגנון ייחוס, השתמשו באחת עד עשר תמונות PNG, JPG או WebP, לא יותר מ־64 MB בסך הכול ופחות מ־20 MB לכל אחת. לכל ייחוס דרושה צלע קצרה של לפחות 256 פיקסלים, צלע ארוכה שאינה עולה על 4,096 פיקסלים ורזולוציה שאינה עולה על 16 מגה־פיקסלים. השתמשו בייחוסים האלה או בסגנון שמור תואם, ולא בשניהם יחד.
פעולת תמונה־לתמונה המתועדת משלבת תמונה קיימת והנחיה, עם עוצמה בין 0 ל־1 שקובעת עד כמה הפלט החדש מתרחק מהמקור. היא אינה מקבלת בקרות סגנון של V4 בפעולה הזו. תיעוד היצירה הנוכחי אינו כולל גם שמות סגנונות שנבחרו מראש, negative_prompt, text_layout, artistic_level ו־no_text. הכינו תיאור חיובי של התוצאה הרצויה והעריכו את הנכס בתוך קומפוזיציית היעד שלו. V4 הרגיל מספק פרשנות עיצוב רסטר ממוקדת, עם מהדורה, פורמט וגודל פלט מסוימים. לתמונה־לתמונה, ספקו PNG, JPG, WebP או SVG בגודל קטן מ־20 MB, לא יותר מ־16 מגה־פיקסלים, עם שתי צלעות בין 256 ל־4,096 פיקסלים.
", "aboutText": "Recraft V4 הוא מודל הרסטר הרגיל בדור V4 של Recraft. היצרן מדגיש שיקול דעת עיצובי: קומפוזיציה מאוזנת, יחסי צבע מגובשים ופרטים שתומכים בכוונה החזותית. הוא יכול לעבוד עם איור מסוגנן, סצנות צילומיות וקונספטים לעיצוב גרפי. השתמשו בו כאשר הבריף דורש תמונה שמשלבת בחירות אסתטיות עם דיוק בהנחיה, בין אם חוקרים אווירה מכיוון קצר ובין אם מגדירים פריסה מכוונת בפירוט.\n\nקוד המודל המדויק הוא recraftv4. תיעוד היצרן שלו מציין פלט רסטר ב־1K בפורמט WebP ללא אובדן או PNG. תמונה ריבועית היא 1024 × 1024 פיקסלים, 16:9 הוא 1344 × 768 ו־2:3 הוא 832 × 1280; יחסים נתמכים אחרים משתמשים בממדים משלהם. V4 Pro הוא מהדורת הרסטר הנפרדת ב־2K, ואילו V4 Vector ו־Pro Vector מחזירים SVG הניתן לעריכה. בחרו את וריאנט V4 המדויק לתוצר המיועד במקום לשלב את תכונות הפלט השונות האלה.\n\nמדריך היצרן מבחין בין הנחיות פרשניות קצרות לבין כיוון יצירתי מובנה. ביטוי קצר יכול להשאיר מקום לחקר צורה, אווירה ומסגור. בריף מובנה יכול לנקוב בנושא, בסביבה, בתנוחה, בחומר, ברכיבים משניים, בתאורה ובהיררכיה חזותית. לאיור סיפורי, תארו רוכב אופניים שחוצה גשר קטן, צורות מפושטות נועזות, צבעים חמים מאופקים ותנועה ברורה משמאל לימין. החלטות התוכן והקומפוזיציה האלה מעשיות יותר מרשימה ארוכה של תארי סגנון שאינם קשורים.\n\nהטווח של V4 כולל איור, דימויים בעלי נפח וחזות פוטוריאליסטית. המדריך ממליץ לתאר היגיון ציור לאיור וחומר, תאורה, מצלמה ועומק לתמונה במראה תלת־ממדי. האחרונה נשארת חזות רסטר ולא רשת גאומטרית הניתנת לעריכה. לכרזה או לקונספט אריזה, ציינו אילו מילים ראשיות, היכן הן שייכות וכיצד התמונה והטיפוגרפיה משתלבות. היצרן מדגיש טקסט קצר ובינוני קריא; בדקו את הניסוח ואת הסידור בפועל בתמונה שהוחזרה לפני שימוש בה.\n\nהיצירה תומכת בהנחיות של עד 10,000 תווים, בערך seed אקראי, באחד עד שישה פלטים, בצבעים מועדפים ובצבע רקע רצוי. סגנונות מותאמים תואמים ותמונות ייחוס אופציונליים יכולים להנחות את הטיפול החזותי באמצעות התאמה גמישה או מדויקת. בחרו ייחוס נקי או מערך השייך לעולם חזותי אחד, ואז תנו להנחיה לתאר את הנושא ואת הסצנה החדשים. התאמת צבע בין הייחוס לפלט אינה מובטחת, לכן הבהירו את הפלטה הנדרשת והשוו אליה את התוצאה. ליצירה בסגנון ייחוס, השתמשו באחת עד עשר תמונות PNG, JPG או WebP, לא יותר מ־64 MB בסך הכול ופחות מ־20 MB לכל אחת. לכל ייחוס דרושה צלע קצרה של לפחות 256 פיקסלים, צלע ארוכה שאינה עולה על 4,096 פיקסלים ורזולוציה שאינה עולה על 16 מגה־פיקסלים. השתמשו בייחוסים האלה או בסגנון שמור תואם, ולא בשניהם יחד.\n\nפעולת תמונה־לתמונה המתועדת משלבת תמונה קיימת והנחיה, עם עוצמה בין 0 ל־1 שקובעת עד כמה הפלט החדש מתרחק מהמקור. היא אינה מקבלת בקרות סגנון של V4 בפעולה הזו. תיעוד היצירה הנוכחי אינו כולל גם שמות סגנונות שנבחרו מראש, negative_prompt, text_layout, artistic_level ו־no_text. הכינו תיאור חיובי של התוצאה הרצויה והעריכו את הנכס בתוך קומפוזיציית היעד שלו. V4 הרגיל מספק פרשנות עיצוב רסטר ממוקדת, עם מהדורה, פורמט וגודל פלט מסוימים. לתמונה־לתמונה, ספקו PNG, JPG, WebP או SVG בגודל קטן מ־20 MB, לא יותר מ־16 מגה־פיקסלים, עם שתי צלעות בין 256 ל־4,096 פיקסלים.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c5312ecdfe6a6af9a22bfe15d6fa150266f33f2dc6fcada7e298797b158d844f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "recraft/recraft-v4Recraft V4 יוצר תמונות רסטר ב־1K עם דגש על קומפוזיציה, יחסי צבע וכיוון יצירתי מפורט. הוא מכסה איור, סצנות פוטוריאליסטיות וקונספטים לעיצוב גרפי, עם קלטי סגנון אופציונליים ותהליך תמונה־לתמונה נפרד.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Recraft V4 הוא מודל הרסטר הרגיל בדור V4 של Recraft. היצרן מדגיש שיקול דעת עיצובי: קומפוזיציה מאוזנת, יחסי צבע מגובשים ופרטים שתומכים בכוונה החזותית. הוא יכול לעבוד עם איור מסוגנן, סצנות צילומיות וקונספטים לעיצוב גרפי. השתמשו בו כאשר הבריף דורש תמונה שמשלבת בחירות אסתטיות עם דיוק בהנחיה, בין אם חוקרים אווירה מכיוון קצר ובין אם מגדירים פריסה מכוונת בפירוט.
קוד המודל המדויק הוא recraftv4. תיעוד היצרן שלו מציין פלט רסטר ב־1K בפורמט WebP ללא אובדן או PNG. תמונה ריבועית היא 1024 × 1024 פיקסלים, 16:9 הוא 1344 × 768 ו־2:3 הוא 832 × 1280; יחסים נתמכים אחרים משתמשים בממדים משלהם. V4 Pro הוא מהדורת הרסטר הנפרדת ב־2K, ואילו V4 Vector ו־Pro Vector מחזירים SVG הניתן לעריכה. בחרו את וריאנט V4 המדויק לתוצר המיועד במקום לשלב את תכונות הפלט השונות האלה.
מדריך היצרן מבחין בין הנחיות פרשניות קצרות לבין כיוון יצירתי מובנה. ביטוי קצר יכול להשאיר מקום לחקר צורה, אווירה ומסגור. בריף מובנה יכול לנקוב בנושא, בסביבה, בתנוחה, בחומר, ברכיבים משניים, בתאורה ובהיררכיה חזותית. לאיור סיפורי, תארו רוכב אופניים שחוצה גשר קטן, צורות מפושטות נועזות, צבעים חמים מאופקים ותנועה ברורה משמאל לימין. החלטות התוכן והקומפוזיציה האלה מעשיות יותר מרשימה ארוכה של תארי סגנון שאינם קשורים.
הטווח של V4 כולל איור, דימויים בעלי נפח וחזות פוטוריאליסטית. המדריך ממליץ לתאר היגיון ציור לאיור וחומר, תאורה, מצלמה ועומק לתמונה במראה תלת־ממדי. האחרונה נשארת חזות רסטר ולא רשת גאומטרית הניתנת לעריכה. לכרזה או לקונספט אריזה, ציינו אילו מילים ראשיות, היכן הן שייכות וכיצד התמונה והטיפוגרפיה משתלבות. היצרן מדגיש טקסט קצר ובינוני קריא; בדקו את הניסוח ואת הסידור בפועל בתמונה שהוחזרה לפני שימוש בה.
היצירה תומכת בהנחיות של עד 10,000 תווים, בערך seed אקראי, באחד עד שישה פלטים, בצבעים מועדפים ובצבע רקע רצוי. סגנונות מותאמים תואמים ותמונות ייחוס אופציונליים יכולים להנחות את הטיפול החזותי באמצעות התאמה גמישה או מדויקת. בחרו ייחוס נקי או מערך השייך לעולם חזותי אחד, ואז תנו להנחיה לתאר את הנושא ואת הסצנה החדשים. התאמת צבע בין הייחוס לפלט אינה מובטחת, לכן הבהירו את הפלטה הנדרשת והשוו אליה את התוצאה. ליצירה בסגנון ייחוס, השתמשו באחת עד עשר תמונות PNG, JPG או WebP, לא יותר מ־64 MB בסך הכול ופחות מ־20 MB לכל אחת. לכל ייחוס דרושה צלע קצרה של לפחות 256 פיקסלים, צלע ארוכה שאינה עולה על 4,096 פיקסלים ורזולוציה שאינה עולה על 16 מגה־פיקסלים. השתמשו בייחוסים האלה או בסגנון שמור תואם, ולא בשניהם יחד.
פעולת תמונה־לתמונה המתועדת משלבת תמונה קיימת והנחיה, עם עוצמה בין 0 ל־1 שקובעת עד כמה הפלט החדש מתרחק מהמקור. היא אינה מקבלת בקרות סגנון של V4 בפעולה הזו. תיעוד היצירה הנוכחי אינו כולל גם שמות סגנונות שנבחרו מראש, negative_prompt, text_layout, artistic_level ו־no_text. הכינו תיאור חיובי של התוצאה הרצויה והעריכו את הנכס בתוך קומפוזיציית היעד שלו. V4 הרגיל מספק פרשנות עיצוב רסטר ממוקדת, עם מהדורה, פורמט וגודל פלט מסוימים. לתמונה־לתמונה, ספקו PNG, JPG, WebP או SVG בגודל קטן מ־20 MB, לא יותר מ־16 מגה־פיקסלים, עם שתי צלעות בין 256 ל־4,096 פיקסלים.
POST /v1/images/generationstext, imageimage| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות recraft/recraft-v4 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שדהn | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 מקסימום: 6 | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 1:1, 4:3, 3:4, 16:9, 9:16, auto | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 0 מספר פריטים מרבי: 1 | ברירת מחדל— |
מטקסט לתמונה · נדרש: prompt
reference_guided_image · נדרש: prompt, actual image reference
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרmaterial_types | מפרטtext, image |
פרמטרoptional_controls | מפרטn, aspect_ratio, input_references |
פרמטרn | מפרט{"minimum":1,"maximum":6} |
פרמטרreference_images | מפרט{"minimum":0,"maximum":1,"source":"חומר ממשי שסופק על ידי הלקוח"} |
פרמטרprovider_specific_options | מפרטרק style/controls/text_layout מתוך רשימת ההיתרים המדויקת השמורה של נקודת הקצה; אין לנחש מבנים. |
כינויים לשיטה: /v1/images
מחזור חיים: 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}
הדוגמה המבוססת על הנחיה בלבד שומרת על מבנה ImageGenerationRequest הרשמי.
יש לשמור כל תמונה שהוחזרה ואת התגובה המלאה; כמות הפלט היא הכמות בפועל, ולא n שהתבקש.
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יחידת חיוב | חיוב |
|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יחידת חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהUltra | טבלת תעריפים— | כמות חזויה— | יחידת חיובלכל תמונה בפלט | חיוב פלט · תמונת פלט · אומדן להשוואה בלבד $0.08 לכל תמונה בפלט |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יחידת חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.08 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהתמונת פלט | תנאי חיובלא הוצהרה חלופת תמחור. | חיוב פלט · תמונת פלט $0.08 לכל תמונה רישומים מקבילים מתארים את אותו חיוב; הם אינם מוסיפים עמלה שנייה. |
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={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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\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\nrequest={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting"};\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 שלה.
יש לשמור כל פריט נתונים ואת נתוני השימוש המלאים; יש להעביר לבעלותכם ולשמור את כל התמונות הממשיות שהוחזרו. אין להמציא כתובות או מזהים.
אם תוצאה של יצירת תמונה או עריכתה דורשת בדיקה, שמרו את 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 Ultra recraft/recraft-v4
/v1/images