דילוג לתוכן

מפתחים · עודכן אוק׳ 2026

OmniHuman 2 API: קלט, מגבלות ואיך זה עובד

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

תמונה+קול=סרטון

קול
אין תמונה? נסו:
  • תצוגה מקדימה בחינם
  • התחברות עם Google
  • העלאות פרטיות
מודעות UGC
שירה
כמה אנשים
לסרטון
5 דק׳
פלט
720p
אנשים בסצנה
כמה
שפות
6

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

מה מכילה בקשה ל־API של OmniHuman 2

לבקשה יש שני שדות חובה ושדה אופציונלי אחד. כתובת ה־URL של התמונה מצביעה על האדם (או האנשים) שיש להנפיש; כתובת ה־URL של האודיו מצביעה על הדיבור או השיר שמניעים את הביצוע; הפרומפט האופציונלי מתאר תנועה, אווירה, פרטי סצנה ותנועת מצלמה. התוצאות נמסרות בדרך כלל באופן אסינכרוני דרך תור: שולחים, מקבלים מזהה בקשה, ואז בודקים את הסטטוס (polling) או מקבלים webhook כשהסרטון מוכן.

  • image_url – חובה; תמונת הסטילס שיש להנפיש.
  • audio_url – חובה; MP3 או WAV שקובע את האורך ואת סנכרון השפתיים.
  • prompt – אופציונלי; נתמך באנגלית, סינית, יפנית, קוריאנית, ספרדית (מקסיקו) ואינדונזית.

מגבלות קלט שכדאי לאמת קודם

בקשות שנדחות מבזבזות זמן ולפעמים גם כסף, אז אמתו אצלכם לפני הקריאה למודל. התמונה חייבת להיות בפורמט נפוץ כמו JPEG, PNG, WEBP, BMP, TIFF, GIF או HEIC, לא יותר מ־30 MB, בין 300 ל־6000 פיקסלים בכל צלע, ביחס רוחב־גובה של 0.4 עד 2.5. האודיו חייב להיות WAV או MP3, עד 15 MB, ובאורך של 4 עד 300 שניות.

הקלטות מהדפדפן הן בדרך כלל WebM או Opus, והמודל לא מקבל אותן. המירו אותן ל־WAV או MP3 לפני ההעלאה – הסטודיו שלנו מקודד מחדש הקלטות ל־WAV מונו ב־22.05 kHz, מה שמשאיר קליפ של חמש דקות מתחת למגבלת הגודל.

פלט וחיוב

משימה שהושלמה מחזירה כתובת URL של קובץ הווידאו ואת המשך שמשמש לחיוב, שתואם את אורך אודיו הקלט. הפלט הוא MP4 ב־720p מקורי. כתובות URL של ספקים עלולות לפוג, ולכן מערכות בייצור צריכות להעתיק את הקובץ לאחסון שלהן מיד כשהמשימה מסתיימת, במקום לקשר ישירות לספק.

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

תהליך מוכן לייצור

הדפוס שאנחנו מריצים בכל רינדור באתר הזה:

  1. 1העלאה לאחסון פרטיהנפיקו כתובות העלאה חתומות קצרות־מועד; לעולם אל תחשפו קישורים ציבוריים ארוכי־טווח לתמונות של משתמשים.
  2. 2אימות בצד השרתמדדו מחדש את אורך האודיו וודאו ששני הקבצים קיימים לפני כל חיוב.
  3. 3לשריין, ואז לשלוחשריינו קרדיטים באופן אטומי, שלחו את המשימה, והחזירו את הקרדיטים אוטומטית אם השליחה נכשלת.
  4. 4סיום אידמפוטנטיב־webhook או ב־polling, משכו את התוצאה, שמרו את ה־MP4 וסמנו את המשימה כהושלמה פעם אחת בדיוק.

מתי הסטודיו ללא קוד הוא הבחירה הטובה יותר

בניית הצנרת שלמעלה דורשת ימים של עבודה: אחסון, אימות, תורים, webhooks, ניסיונות חוזרים וחיוב. אם המטרה שלכם היא תוכן ולא פיצ'ר במוצר, הסטודיו שלנו נותן לכם את אותו פלט של OmniHuman 2.0 כשכל זה כבר מוכן. אנחנו לא מציעים API ציבורי בעצמנו; האתר הזה מיועד ליוצרים ולאנשי שיווק שרוצים סרטונים מוכנים.

טיפול בכשלים ובניסיונות חוזרים

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

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

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

שאלות נפוצות

omnihuman2.ai מציע API ציבורי?

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

מה אורך האודיו המרבי ב־API של OmniHuman 2?

300 שניות. המינימום הוא 4 שניות, והקובץ חייב להיות MP3 או WAV עד 15 MB.

באיזו רזולוציה ה־API מחזיר וידאו?

גרסה 2.0 מרנדרת באופן מקורי ב־720p ומחזירה קובץ MP4.

ה־API סינכרוני?

בדרך כלל לא. משימות לוקחות דקות, ולכן הספקים משתמשים בתור עם polling או webhooks.

אפשר לשלוח הקלטת WebM?

לא ישירות. המירו אותה קודם ל־WAV או MP3; רוב ההקלטות מהדפדפן דורשות קידוד מחדש.

איך מחויב השימוש?

לפי שניות של פלט, ששוות לאורך אודיו הקלט.

כדאי להעתיק את סרטון הפלט לאחסון שלי?

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

כמה זמן לוקחת משימה בדרך כלל?

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

להמשיך לגלות

תנו לתמונה שלכם לדבר.

תצוגה מקדימה בחינם.