Έγγραφα προγραμματιστή UlazAI
Google Veo 3.1 Γενιά βίντεο API
Google Veo 3.1 Γενιά βίντεο API
Δημιουργήστε βίντεο με το Veo 3.1 χρησιμοποιώντας τα υποστηριζόμενα στοιχεία ελέγχου καρέ και τη ροή εργασιών κατάστασης εργασίας.
✨ ΝΕΟ: Τα Veo 3.1 Lite, Fast και Quality είναι διαθέσιμα με έλεγχο πρώτου και τελευταίου καρέ.
✨ Χαρακτηριστικά Veo 3.1
✅ Τρεις επιλογές μοντέλων - Lite, γρήγορο και ποιοτικό
✅ Έλεγχος πλαισίου - Ορίστε εικόνες πρώτου και τελευταίου καρέ
✅ Κείμενο σε βίντεο και εικόνα σε βίντεο
✅ Βίντεο 8 δευτερολέπτων με εγγενή ήχο
✅ Υποστήριξη υδατογραφήματος - Προσθήκη κειμένου επωνυμίας
✅ Προαιρετική εναλλακτική λειτουργία για δεύτερη προσπάθεια μοντέλου
✅ Αυτόματη μετάφραση στα αγγλικά
✅ Πολλαπλοί λόγοι διαστάσεων (16:9, 9:16, Αυτόματο)
💰 Τιμές
💸 Veo 3.1 Lite
40 πιστώσεις
Λειτουργία καλύτερης αξίας
Κείμενο σε βίντεο + εικόνα σε βίντεο
⚡ Veo 3.1 Fast
100 πιστώσεις
~0,92$ ανά βίντεο
Ο χρόνος ποικίλλει ανάλογα με την ουρά
💎 Ποιότητα Veo 3.1
220 πιστώσεις
~2,31$ ανά βίντεο
Ο χρόνος ποικίλλει ανάλογα με την ουρά
🛡️ Εναλλακτική λειτουργία
+200 πιστώσεις
Προαιρετικό πρόσθετο
Η επιστροφή δεν εγγυάται την επιτυχία
/veo31/api/generate/
Δημιουργήστε βίντεο Veo 3.1
Δημιουργήστε ένα βίντεο 8 δευτερολέπτων με το Google Veo 3.1 χρησιμοποιώντας κείμενο prompt και προαιρετικά καρέ εικόνας.
Σώμα αιτήματος
{
"prompt": "A golden retriever running through a field of flowers at sunset",
"model": "veo3_lite", // Options: "veo3_lite", "veo3_fast", "veo3"
"aspectRatio": "16:9", // Options: "16:9", "9:16", "Auto"
"imageUrls": [], // Optional: Array of 1-2 image URLs
"seeds": 42069, // Optional: 10000-99999 for reproducible results
"watermark": "UlazAI", // Optional: Max 50 characters
"enableFallback": false, // Optional fallback attempt; check current extra credits
"enableTranslation": true // Optional: Auto-translate to English
}
Παράμετροι
prompt * (χορδή)
Περιγραφή κειμένου του βίντεο προς δημιουργία. Έως 5000 χαρακτήρες. Να είστε περιγραφικοί σχετικά με τις ενέργειες, τις κινήσεις της κάμερας και την ατμόσφαιρα.
μοντέλο * (χορδή)
Μοντέλο προς χρήση: veo3_lite (40 πιστώσεις), veo3_fast (100 πιστώσεις), ή veo3 (220 πιστώσεις)
Αναλογία διαστάσεων (χορδή)
Αναλογία διαστάσεων βίντεο: 16:9 (τοπίο), 9:16 (πορτρέτο), Auto (αυτόματο). Προεπιλογή: 16:9
imageUrls (πίνακας)
Προαιρετικός πίνακας 1-2 διευθύνσεων URL εικόνας για έλεγχο πλαισίου:
• 1 εικόνα: Το βίντεο επικεντρώνεται γύρω από αυτήν την εικόνα
• 2 εικόνες: Μετάβαση βίντεο από το πρώτο στο τελευταίο καρέ
Μέγιστο 10 MB ανά εικόνα, μόνο JPG/PNG
σπόρους (ακέραιος αριθμός)
Προαιρετικός σπόρος για αναπαραγώγιμα αποτελέσματα. Εύρος: 10000-99999
υδατογράφημα (χορδή)
Προαιρετικό κείμενο υδατογραφήματος για επικάλυψη σε βίντεο. Μέγιστο 50 χαρακτήρες. Εξαιρετικό για branding.
ενεργοποιήστε το Fallback (Boolean)
Ενεργοποιήστε μια προαιρετική προσπάθεια δημιουργίας αντιγράφων ασφαλείας. Ελέγξτε το τρέχον επιπλέον κόστος πίστωσης. Η εναλλακτική δεν εγγυάται την ολοκλήρωση. Προεπιλογή: false
enableTranslation (Boolean)
Αυτόματη μετάφραση του prompt στα αγγλικά για καλύτερα αποτελέσματα. Υποστηρίζει όλες τις γλώσσες. Προεπιλογή: true
Απόκριση επιτυχίας (201)
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"credits_charged": 100,
"credits_remaining": 900,
"estimated_time": "varies by queue",
"message": "Veo 3.1 video generation started successfully"
}
}
Απόκριση σφάλματος (400)
{
"success": false,
"error": "Insufficient credits. Required: 100, Available: 50"
}
Παράδειγμα cURL - Μετατροπή κειμένου σε βίντεο
curl -X POST https://ulazai.com/veo31/api/generate/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A golden retriever running through a field of flowers at sunset, slow motion, cinematic lighting",
"model": "veo3_fast",
"aspectRatio": "16:9",
"watermark": "MyBrand",
"enableTranslation": true
}'
Παράδειγμα cURL - Εικόνα σε βίντεο με έλεγχο καρέ
curl -X POST https://ulazai.com/veo31/api/generate/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The character slowly turns their head and smiles at the camera",
"model": "veo3",
"aspectRatio": "16:9",
"imageUrls": ["https://your-domain.com/start-frame.jpg"],
"seeds": 42069,
"enableFallback": true
}'
Παράδειγμα Python
import requests
import time
API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com"
# Generate video
response = requests.post(
f"{BASE_URL}/veo31/api/generate/",
headers={
"Authorization": f"Token {API_KEY}",
"Content-Type": "application/json"
},
json={
"prompt": "A serene mountain lake at sunrise with mist rising from the water",
"model": "veo3_fast",
"aspectRatio": "16:9",
"watermark": "MyBrand"
}
)
data = response.json()
if data["success"]:
task_id = data["data"]["task_id"]
print(f"Task created: {task_id}")
# Poll for completion
while True:
status_response = requests.get(
f"{BASE_URL}/veo31/api/status/{task_id}/",
headers={"Authorization": f"Token {API_KEY}"}
)
status_data = status_response.json()
if status_data["data"]["status"] == "completed":
video_url = status_data["data"]["video_url"]
print(f"Video ready: {video_url}")
break
elif status_data["data"]["status"] == "failed":
print(f"Generation failed: {status_data['data']['error_message']}")
break
time.sleep(5) # Poll every 5 seconds
else:
print(f"Error: {data['error']}")
/veo31/api/status/<task_id>/
Ελέγξτε την κατάσταση δημιουργίας
Ελέγξτε την κατάσταση μιας εργασίας δημιουργίας βίντεο Veo 3.1.
Απάντηση – Επεξεργασία
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "processing",
"model": "veo3_fast",
"prompt": "A golden retriever running through flowers",
"credits_charged": 100
}
}
Απάντηση - Ολοκληρώθηκε
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "completed",
"video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
"thumbnail_url": "https://cdn.ulazai.com/videos/veo31_abc123_thumb.jpg",
"resolution": "1080p",
"duration": 8,
"aspect_ratio": "16:9",
"fallback_used": false,
"credits_charged": 100
}
}
Απόκριση - Απέτυχε
{
"success": true,
"data": {
"task_id": "veo31_abc123def456",
"status": "failed",
"error_message": "Content policy violation. Enable fallback mode to retry.",
"credits_refunded": 100
}
}
Παράδειγμα cURL
curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
-H "Authorization: Token YOUR_API_KEY"
/veo31/api/upload-frame/
Μεταφόρτωση εικόνας πλαισίου
Ανεβάστε μια εικόνα για έλεγχο καρέ (πρώτο ή τελευταίο καρέ). Επιστρέφει μια διεύθυνση URL για χρήση στο τελικό σημείο δημιουργίας.
Αίτημα (πολυμερή/φόρμα-δεδομένα)
Content-Type: multipart/form-data
image: (binary file data)
Παράμετροι
εικόνα * (αρχείο)
Αρχείο εικόνας για μεταφόρτωση. Μέγιστο 10MB. Υποστηριζόμενες μορφές: JPG, PNG. Προτεινόμενη ανάλυση: 1920x1080 ή υψηλότερη.
Απόκριση επιτυχίας (200)
{
"success": true,
"url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
"message": "Image uploaded successfully"
}
Παράδειγμα cURL
curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
-H "Authorization: Token YOUR_API_KEY" \
-F "image=@/path/to/your/image.jpg"
Κωδικοί κατάστασης
200 ΟΚ - Το αίτημα επιτυχής
201 Δημιουργήθηκε - Η εργασία δημιουργίας δημιουργήθηκε με επιτυχία
400 Κακό αίτημα - Μη έγκυρες παράμετροι ή ανεπαρκείς πιστώσεις
401 Μη εξουσιοδοτημένο - Λείπει ή δεν είναι έγκυρο το κλειδί API
404 Δεν βρέθηκε - Το Task ID δεν βρέθηκε
413 Ωφέλιμο φορτίο Πολύ μεγάλο - Η εικόνα υπερβαίνει το όριο των 10 MB
429 Πάρα πολλά αιτήματα - Υπέρβαση του ορίου τιμής
500 Εσωτερικό σφάλμα διακομιστή - Σφάλμα διακομιστή, επικοινωνήστε με την υποστήριξη
Τιμές κατάστασης εργασίας
σε εκκρεμότητα - Δημιουργήθηκε εργασία, σε αναμονή για έναρξη
επεξεργασία - Γίνεται δημιουργία βίντεο
ολοκληρωθεί - Η δημιουργία βίντεο ήταν επιτυχής, το video_url είναι διαθέσιμο
απέτυχε - Η δημιουργία απέτυχε, οι πιστώσεις επιστρέφονται αυτόματα
💡 Βέλτιστες πρακτικές
Χρησιμοποιήστε περιγραφικά prompt
Συμπεριλάβετε λεπτομέρειες σχετικά με τις ενέργειες, τις κινήσεις της κάμερας, τον φωτισμό και την ατμόσφαιρα. Παράδειγμα: "Κοντινό πλάνο αργής κίνησης με σταγόνες νερού που πέφτουν, με οπίσθιο φωτισμό από χρυσό ηλιοβασίλεμα, ρηχό βάθος πεδίου"
Ενεργοποίηση εναλλακτικής λύσης για σημαντικό περιεχόμενο
Για σημαντικές εργασίες, εξετάστε την προαιρετική εναλλακτική προσπάθεια και εξακολουθήστε να χειρίζεστε γενιές που απέτυχαν ή απορρίφθηκαν στη ροή εργασίας σας.
Χρησιμοποιήστε σπόρους για συνοχή
Εάν χρειάζεται να αναδημιουργήσετε παρόμοια βίντεο, χρησιμοποιήστε την ίδια τιμή αρχικής τιμής (10000-99999) για πιο συνεπή αποτελέσματα.
Έλεγχος πλαισίου για επωνυμία
Ανεβάστε 1 εικόνα για να κεντράρετε το βίντεό σας γύρω από αυτήν ή 2 εικόνες για να δημιουργήσετε μια ομαλή μετάβαση. Ιδανικό για συνεπή βίντεο χαρακτήρων ή προϊόντων.
Κατάσταση δημοσκόπησης αποτελεσματικά
Δημοσκόπηση κάθε 5 δευτερόλεπτα για τη γρήγορη λειτουργία, 10 δευτερόλεπτα για τη λειτουργία ποιότητας. Μην κάνετε δημοσκόπηση πιο συχνά για να αποφύγετε τα όρια ποσοστών.
📝 Παράδειγμα Prompts
✅ Καλό Prompt
"Ένας μεγαλοπρεπής αετός πετάει πάνω από χιονισμένα βουνά την αυγή, χρυσό φως φωτίζει τα φτερά του, κάμερα αργής κίνησης που παρακολουθεί λήψη από κάτω, κινηματογραφική σύνθεση"
✅ Καλό Prompt
"Κοντινό πλάνο ενός barista που χύνει latte art, ατμός που αναδύεται από το φλιτζάνι, ζεστός φωτισμός καφέ, ρηχό βάθος πεδίου, προοπτική φακού μακρο"
❌ Κακή Prompt
"αετός που πετάει"
Πολύ ασαφής - λείπουν λεπτομέρειες σχετικά με τη ρύθμιση, την κίνηση, τη γωνία της κάμερας
Χρειάζεστε βοήθεια;
Αντιμετωπίζετε προβλήματα με το Veo 3.1 API; Είμαστε εδώ για να βοηθήσουμε!