הפניית API

תיעוד API מלא ליצירת וידאו Veo 3.1 AI

סקירה כללית

Veo 3.1 API מאפשר לך ליצור סרטוני AI באופן תכנותי מתיאורי טקסט או תמונות. ה-RESTful API שלנו תוכנן להיות פשוט, חזק וקל לשילוב באפליקציות שלך.

כתובת URL בסיסית

https://veo3o1.com/api

אימות

כל בקשות ה-API דורשות אימות באמצעות מפתח API. כלול את מפתח ה-API שלך בכותרת Authorization:

Authorization: Bearer YOUR_API_KEY

אתה יכול ליצור מפתחות API מלוח הבקרה של החשבון שלך.


יצירת וידאו

צור סרטון AI חדש מטקסט או תמונה.

נקודת קצה

POST /generate-video

גוף הבקשה

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

פרמטרים

פרמטרסוגנדרשתיאור
generationTypestringכןסוג היצירה: text_to_video או image_to_video
promptstringכןתיאור הסרטון שברצונך ליצור
aspectRatiostringלאיחס גובה-רוחב של הסרטון. ברירת מחדל: auto
imageUrlstringמותנהנדרש אם generationType הוא image_to_video
imageKeystringלאמפתח אחסון לתמונות שהועלו

תגובה

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

דוגמה

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

קבלת סטטוס וידאו

בדוק את הסטטוס של בקשת יצירת וידאו.

נקודת קצה

GET /video-status/{uuid}

פרמטרים

פרמטרסוגנדרשתיאור
uuidstringכןUUID של הסרטון מבקשת היצירה

תגובה

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

ערכי סטטוס

  • pending: הסרטון בתור לעיבוד
  • processing: הסרטון נוצר
  • completed: הסרטון מוכן וזמין להורדה
  • failed: היצירה נכשלה (בדוק הודעת שגיאה)

העלאת תמונה

העלה תמונה ליצירת וידאו מתמונה.

נקודת קצה

POST /upload-video-image

בקשה

השתמש ב-multipart/form-data להעלאת קובץ התמונה.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

תגובה

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

פורמטים נתמכים

  • JPEG/JPG
  • PNG
  • WebP
  • גודל קובץ מקסימלי: 50MB

קודי שגיאה

קודתיאור
0הצלחה
1000פרמטרים לא חוקיים
1001אין מספיק קרדיטים
1002האימות נכשל
1003חריגה ממגבלת קצב
5000שגיאת שרת

דוגמה לתגובת שגיאה

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

שיטות עבודה מומלצות

  1. סקירה אחראית: בדוק את סטטוס הסרטון כל 5-10 שניות, לא ברציפות
  2. טיפול בשגיאות: יישם לוגיקת ניסיון חוזר עם backoff מעריכי
  3. שמירת תוצאות במטמון: אחסן סרטונים שנוצרו כדי למנוע יצירה מחדש
  4. השתמש ב-webhooks: יעיל יותר מסקירה להתראות השלמה
  5. אימות קלט: בדוק אורך הנחיה ופורמטי תמונה לפני קריאות API

תמיכה

צריך עזרה עם ה-API?