Μετάβαση στο περιεχόμενο

Έγγραφα προγραμματιστή 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; Είμαστε εδώ για να βοηθήσουμε!