וידאו

יצירת משימה

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

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

curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

בדיקת סטטוס מחזורית

• קראו משימה באמצעות GET /videos/{video_id}.
• התייחסו לסטטוס סופי כמקור האמת להשלמה.
• השתמשו במרווח הולך וגדל בין בדיקות והפסיקו כשהמשתמש עוזב.

עבודה עם התוצאה

לאחר השלמה, השתמשו ב-URL או בתוכן שהחזירה המשימה ואמתו שהקובץ מוכן לפני הצגת נגן.

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