הפניית 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
}פרמטרים
| פרמטר | סוג | נדרש | תיאור |
|---|---|---|---|
generationType | string | כן | סוג היצירה: text_to_video או image_to_video |
prompt | string | כן | תיאור הסרטון שברצונך ליצור |
aspectRatio | string | לא | יחס גובה-רוחב של הסרטון. ברירת מחדל: auto |
imageUrl | string | מותנה | נדרש אם generationType הוא image_to_video |
imageKey | string | לא | מפתח אחסון לתמונות שהועלו |
תגובה
{
"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}פרמטרים
| פרמטר | סוג | נדרש | תיאור |
|---|---|---|---|
uuid | string | כן | 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
}
}שיטות עבודה מומלצות
- סקירה אחראית: בדוק את סטטוס הסרטון כל 5-10 שניות, לא ברציפות
- טיפול בשגיאות: יישם לוגיקת ניסיון חוזר עם backoff מעריכי
- שמירת תוצאות במטמון: אחסן סרטונים שנוצרו כדי למנוע יצירה מחדש
- השתמש ב-webhooks: יעיל יותר מסקירה להתראות השלמה
- אימות קלט: בדוק אורך הנחיה ופורמטי תמונה לפני קריאות API
תמיכה
צריך עזרה עם ה-API?
- 📧 אימייל: aiprocessingrobot@gmail.com
- 💬 צור קשר עם התמיכה