Source: https://ailoot.ai/models/he/viduq2/
Canonical: https://ailoot.ai/models/he/viduq2/
Language: he

# Vidu: Q2 Text-to-Video

[Markdown](https://ailoot.ai/models/he/viduq2/index.md) · [JSON](https://ailoot.ai/models/he/viduq2/facts.json)

## [Vidu: Q2 Text-to-Video](https://ailoot.ai/models/he/viduq2/)

Vidu Q2 יוצר וידאו מהנחיות טקסט לסצנה, עם משך של 1–10 שניות, פלט 540p, 720p או 1080p וחמישה יחסי ממדים. פרופיל viduq2 המסוים הזה משתמש בפרומפט לקביעת הסגנון והתנועה ומחזיר את התוצאה דרך משימה אסינכרונית.

- [**Ailoot Ultra · וידאו** `POST /v1/videos` `viduq2`](https://ailoot.ai/models/he/viduq2/#method-0)

על המודל

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

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

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

מגבלת הפרומפט היא 2,000 תווים. שימו תחילה את נושא הצילום ואת הפעולה העיקריים, ואז הוסיפו פרטי תאורה, חומר, סביבה ומצלמה המשנים את התוצאה הרצויה. הגדירו את הסגנון החזותי בפרומפט. המדריך הייעודי של Q2 אומר שהפרמטרים הנפרדים style ו-movement\_amplitude אינם משפיעים על המודל הזה, ולכן ההגדרות המוכנות general או anime ואפשרויות עוצמת התנועה אינן תחליף לתיאור סצנה ברור.

הגדרת המשך של המודל מקבלת שניות שלמות מאחת עד עשר. אפשרויות הרזולוציה הייעודיות של Q2 הן 540p, 720p ו-1080p, כש-720p היא ברירת המחדל המתועדת. בחרו יחד משך ורזולוציה לפי הפעולה והיעד. חשיפה קצרה ותנועה ארוכה יותר זקוקות לתזמון שונה; הגדלת המשך המבוקש צריכה לשרת את הרצף הגלוי, במקום רק למתוח הנחיות שלא השתנו. בדקו את המידות ואת האורך בפועל של הקליפ שהוחזר בעת הכנתו להצבה הסופית.

אפשרויות aspect\_ratio המתועדות הן 16:9, 9:16, 3:4, 4:3 ו-1:1, עם 16:9 כברירת המחדל. המדריך כולל במפורש 3:4 ו-4:3 למשפחת Q2. בחרו את המסגרת לפני היצירה ותארו קומפוזיציה המתאימה לה: שמרו על נושא צילום ראשי ברור במבט אנכי, או השתמשו ברוחב המסגרת האופקית להצגת הסביבה. השאירו את מבט הסיום ברור מספיק לעמוד המיועד, למצגת או להוספת כיתוב בהמשך.

שדה seed שולט בשונות. השמטתו או מתן 0 בוחרים ערך אקראי; ערך שאינו אפס בוחר באפשרות ה-seed הקבוע המתועדת ליצירה חוזרת הניתנת לשחזור. שמרו את ה-seed שהוחזר עם הפרומפט וההגדרות כשמשווים גרסאות. הפעולה המשותפת מתעדת גם את בקרות audio ו-off\_peak במיוחד למודלי Q3. האפשרויות האלה של Q3 אינן יכולות המשויכות לפרופיל Q2 הזה; תכננו את הבקשה סביב קלט הטקסט ופלט הווידאו המתועדים שלו.

היצירה אסינכרונית. השליחה מחזירה task\_id ומצב התחלתי, כאשר created משמש למשימה שנוצרה זה עתה. שמרו את זהות המשימה הזאת בעת מעקב אחר העיבוד. שאילתת התוצאה המתועדת משתמשת ב-state=success לתוצאה מוצלחת ומחזירה מערך creations. לכל רשומה יש כתובת וידאו ב-creations\[\].url; שמרו כל וידאו שהוחזר, במקום להניח שבמשימה תמיד יש בדיוק תוצר אחד.

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

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

**Ailoot Ultra · וידאו** `POST /v1/videos` `viduq2`

[`viduq2`](https://ailoot.ai/models/he/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos)

Vidu /`viduq2`

### התחלה

Vidu Q2 יוצר וידאו מהנחיות טקסט לסצנה, עם משך של 1–10 שניות, פלט 540p, 720p או 1080p וחמישה יחסי ממדים. פרופיל viduq2 המסוים הזה משתמש בפרומפט לקביעת הסגנון והתנועה ומחזיר את התוצאה דרך משימה אסינכרונית.

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

טקסט

תוצאות

וידאו

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

**Ailoot Ultra · וידאו** `POST /v1/videos`

סוגי קלט

`text`

סוגי פלט

`video`

| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
| --- | --- | --- | --- | --- |
| שדה`model` | סוג`string` | דרישהחובה | ערכים ומגבלות viduq2 | ברירת מחדל— |
| שדה`prompt` | סוג`string` | דרישהחובה | ערכים ומגבלות תנאים: תארו את הסצנה שתיווצר. המגבלה המתועדת היא 2000 תווים; Ailoot בודקת שהמחרוזת אינה ריקה ושומרת את הטקסט. | ברירת מחדל— |
| שדה`duration` | סוג`integer` | דרישהרשות | ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦10⁩ תנאים: התיאור הייחודי למודל viduq2 מציין 1–10 שניות שלמות. לא מתועד משך ברירת מחדל ייחודי למודל. יחידה: שניות | ברירת מחדל— |
| שדה`seed` | סוג`string` | דרישהרשות | ערכים ומגבלות תנאים: יש להשמיט או לשלוח את המחרוזת "0" לקבלת אקראיות. ערך seed שונה מאפס שנמסר בוחר בהתנהגות המתועדת של seed קבוע; לא מצוין טווח מספרי. | ברירת מחדל— |
| שדה`aspect_ratio` | סוג`string` | דרישהרשות | ערכים ומגבלות 16:9, 9:16, 3:4, 4:3, 1:1 | ברירת מחדל16:9 |
| שדה`resolution` | סוג`string` | דרישהרשות | ערכים ומגבלות 540p, 720p, 1080p תנאים: הרשימה הייחודית למודל viduq2 מתעדת את המדרגות האלה עבור 1–10 שניות. enum משותף וטבלה מזכירים גם 360p; תחולתו סותרת את הרשימה הזו ואינה נקבעת כאן. | ברירת מחדל720p |
| שדה`style` | סוג`string` | דרישהרשות | ערכים ומגבלות general, anime תנאים: מבנה הבקשה המשותף מקבל את השדה הזה, אך התיעוד מציין במפורש שאין לו השפעה עבור viduq2. | ברירת מחדלgeneral |
| שדה`movement_amplitude` | סוג`string` | דרישהרשות | ערכים ומגבלות auto, small, medium, large תנאים: מבנה הבקשה המשותף מקבל את השדה הזה, אך התיעוד מציין במפורש שאין לו השפעה במודלי q2. | ברירת מחדלauto |

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

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

| פרמטר | מפרט |
| --- | --- |
| פרמטר`content_type` | מפרטapplication/json |
| פרמטר`required` | מפרטmodel, prompt |
| פרמטר`optional` | מפרטduration, seed, aspect\_ratio, resolution, style, movement\_amplitude |
| פרמטר`material_types` | מפרטtext |
| פרמטר`additional_properties` | מפרטtrue |
| פרמטר`validation_scope` | מפרטAiloot מאמתת שמחרוזות model/prompt אינן ריקות. הטיפוסים והמגבלות האופציונליים שלהלן הם חוזה הבקשה המתועד; יתר שדות הבקשה נשמרים עבור המודל שנבחר. |

כינויים לשיטה: `/v1/videos/generations`

מחזור חיים: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`GET /v1/videos/generations/{request_id}/content`

יש ליצור פעם אחת ולשמור את id הציבורי ואת polling\_url שהוחזרו.

יש לבדוק את הפעולה המקורית במחזוריות ולקרוא את state; ערך success ותוצאה בבעלותכם ב־creations\[\].url הם התנאים להשלמה.

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

### תעריפים

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

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

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

מצב מהיר

לא צוין כאשר נבחר מצב מהיר

מצב Flex

לא צוין כאשר נבחר מצב flex

מאמץ חשיבה מרבי

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

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

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

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

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

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. [איך פועלים שריון הסכום והסדרת החיוב →](https://ailoot.ai/docs/he/billing/reserve/)

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

#### Ailoot Ultra · וידאו

curl · צרו סרטוןcurl · קראו את המשימה המקוריתcurl · הורידו כל סרטון שבבעלותכם

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"viduq2","prompt":"In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene."}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
```

```bash
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("state")!="success":raise SystemExit("Poll the same original job until its owned result is returned.")
creations=r.get("creations")
if not isinstance(creations,list) or not creations:raise SystemExit("No completed video creations.")
urls=[]
for item in creations:
    value=item.get("url") if isinstance(item,dict) else None
    values=[value] if isinstance(value,str) else value
    if not isinstance(values,list) or not values:raise SystemExit("No completed video URL.")
    for u in values:
        if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
        p=urlsplit(u)
        if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for the actual Ailoot-owned signed result.")
        urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt
```

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

#### Ailoot Ultra · וידאו

JSON משמר את state ואת מערך creations בפורמט המקורי, עם תוספת של id/provider\_task\_id/polling\_url ציבוריים. כתובות הווידאו שנבחרו ריקות לפני הפרסום והופכות לכתובות חתומות בבעלות Ailoot לאחר ההשלמה.

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

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

שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.

יש להוריד כל כתובת URL ממשית שהוחזרה ב־creations\[\].url; אינדקס תוכן מזהה פלט ממשי אחד שהוחזר.

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

ההצהרה המקובעת אינה מונה מצב כשל סופי. יש לשמור את התגובה המקורית, הכותרות והמזהה ולבדוק את אותה פעולה בכל מצב בלתי מוכר או בשגיאת result\_pending\_check; אין לשלוח שוב בקשת יצירה שמצבה אינו ידוע.

שדות התגובה

| שדה | סוג | משמעות |
| --- | --- | --- |
| שדה`id` | סוגstring | משמעותמזהה ציבורי של משימת Ailoot או של פעולה שהוחזר. |
| שדה`provider_task_id` | סוגstring | משמעותמזהה המשימה המקורי, הנפרד מ־id הציבורי. |
| שדה`polling_url` | סוגstring | משמעותנתיב האיתור של Ailoot שהוחזר עבור המשימה המקורית. |
| שדה`task_id` | סוגstring when supplied | משמעותהמזהה המקורי המופיע בתגובת היצירה. |
| שדה`state` | סוגstring when supplied | משמעותמצב המשימה בממשק המקורי: created למצב ההמתנה המקובע ו־success להשלמה. |
| שדה`err_code` | סוגstring when supplied | משמעותאבחון המשימה; המפרט השמור אינו מגדיר רשימה מונה של קודי שגיאה. |
| שדה`creations[].url` | סוגstring\|string\[\] | משמעותכל כתובת URL שנבחרה של וידאו שהושלם מוחלפת בכתובת URL חתומה בבעלות Ailoot. |
| שדה`creations[].video.duration` | סוגnumber when supplied | משמעותמשך הווידאו שהוחזר; יש לבדוק את התוצאה הממשית שהושלמה. |
| שדה`creations[].video.fps` | סוגinteger when supplied | משמעותקצב הפריימים שהוחזר; אין הבטחה לקצב פריימים קבוע. |
| שדה`creations[].video.resolution.width` | סוגinteger when supplied | משמעותרוחב הפלט שהוחזר בפיקסלים. |
| שדה`creations[].video.resolution.height` | סוגinteger when supplied | משמעותגובה הפלט שהוחזר בפיקסלים. |

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

| תגובה | תנאי | השלב הבא |
| --- | --- | --- |
| תגובה⁦400⁩ · `invalid_request_error` | תנאיJSON/model לא תקפים, מחרוזות חובה חסרות או ריקות, או אינדקס תוכן לא תקף. | השלב הבא |
| תגובה⁦401⁩ · `authentication_error` | תנאימפתח API לא תקף של Ailoot. | השלב הבא |
| תגובה⁦403⁩ · `permission_error` | תנאיהקבוצה של מפתח ה־API אינה מורשית להשתמש בנתיב המדיה הזה. | השלב הבא |
| תגובה⁦404⁩ · `not_found_error` | תנאיהמשימה המקורית או הפלט המבוקש חסרים או אינם בבעלות אותו משתמש, מפתח API וקבוצה. | השלב הבא |
| תגובה⁦502⁩ · `result_pending_check` | תנאיהשליחה המקורית או הסטטוס אינם שלמים או שלא ניתן ליישב ביניהם; יש לשמור את המזהה המקורי ולא לשלוח שוב. | השלב הבא |
| תגובה⁦503⁩ · `result_pending_check` | תנאיהקישור המקורי, הנתיב או המדיה שבבעלותכם עדיין נבדקים; יש להמשיך לבדוק את הפעולה המקורית הזו. | השלב הבא |
| תגובה⁦503⁩ · `server_error` | תנאישירות המדיה או אחסון המשימה המקורית אינם זמינים. | השלב הבא |

### כינויים

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

**Ailoot Ultra** [`viduq2`](https://ailoot.ai/models/he/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos)

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

`/v1/videos/generations`

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

[`viduq2`](https://ailoot.ai/models/he/#m=viduq2&route=Ultra&caller=viduq2&fmt=videos)

FAQ · Vidu: Q2 Text-to-Video

אילו קלטים ותוצאות זמינים?

`POST /v1/videos` · `viduq2`: `text` → `video`

באילו שדות הבקשה משתמשת?

`POST /v1/videos` · `viduq2`: `model`, `prompt`, `duration`, `seed`, `aspect_ratio`, `resolution`, `style`, `movement_amplitude`

אילו מגבלות חלות?

`POST /v1/videos` · `viduq2`: `duration.minimum`: `1`; `duration.maximum`: `10`

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

## החברה ופורטפוליו הפרויקטים שלה

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

## קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

מנוי

בחרו מסלול עם הנחה לבקשות הקבועות שלכם.

קוד הנחה עד 50%

הזינו קוד ברכישה. המחיר יחושב מחדש לפי המבצע הפעיל.

הוצאות בהיסטוריה

המודל, האסימונים והסכום נשמרים לכל בקשה.

[בחירת מנוי](https://ailoot.ai/docs/he/billing/subscriptions/) · [מחירי מודלים](https://ailoot.ai/models/he/)

## חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

יישום מסחרי

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

רישיון למכירה מחדש

שלחו תיאור פרויקט ואופן מתן גישה. בקשו תנאי שימוש ומכירה מחדש בכתב.

מסמכים באתר

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

[בקשת רישיון למכירה מחדש](mailto:support@ailoot.ai) · [ההצעה והסכם הרישוי](https://ailoot.ai/legal/offer?lang=he)

## Ailoot · החברה ופורטפוליו הפרויקטים שלה





Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.





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





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