Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Επέκταση βίντεο με /v1/videos/extensions

Μάθημα 8 / 12 Ενημερώθηκε 2 Νοεμβρίου 2026 Μέσου επιπέδου
Σε αυτήν τη σελίδα
  1. Επέκταση ενός υπάρχοντος βίντεο
  2. Το endpoint POST /v1/videos/extensions
  3. Τρεις τρόποι συνέχισης μιας σκηνής
  4. Αλυσιδωτή σύνδεση επεκτάσεων για τη δημιουργία μιας ακολουθίας
  5. Το δίδυμο δημιουργία και μετά επέκταση
  6. Βασικά σημεία

Το μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026 με βάση την αναφορά του xAI Video API: η επέκταση λαμβάνει το βίντεο σε ένα αντικείμενο video ({"url": ...}), ακριβώς όπως η επεξεργασία—το προηγούμενο κείμενο υποστήριζε το αντίθετο—το αποτέλεσμα διαβάζεται από το video.url και η πηγή περιορίζεται στα 15 δευτερόλεπτα. Πηγές: Video Extension · Video Reference.

Επέκταση ενός υπάρχοντος βίντεο

Ενώ η επεξεργασία μεταμορφώνει μια ακολουθία χωρίς να αλλάζει τη διάρκειά της, η επέκταση κάνει ακριβώς το αντίθετο: επιμηκύνει ένα βίντεο δημιουργώντας μια συνέχεια συνεπή με ό,τι προηγήθηκε. Αυτό λύνει το πιο συχνό πρόβλημα στη δημιουργία βίντεο: ένα επιτυχημένο κλιπ που είναι πολύ σύντομο ή μια σκηνή που αξίζει να εξελιχθεί πέρα από την αρχική της διάρκεια. Αντί να ξαναδημιουργήσετε τα πάντα ελπίζοντας να αναπαράγετε την ίδια αισθητική, ξεκινάτε από αυτό που υπάρχει και συνεχίζετε.

Το endpoint POST /v1/videos/extensions

Το αίτημα μοιάζει με ένα αίτημα δημιουργίας, με την προσθήκη του αρχικού βίντεο.

{
  "model": "grok-imagine-video",
  "prompt": "Continue the scene with a zoom out revealing the full landscape",
  "video": {"url": "https://exemple.com/video-courte.mp4"},
  "duration": 5
}

Το πεδίο model παραμένει grok-imagine-video, το prompt περιγράφει τι πρέπει να συμβεί στη συνέχεια, το αντικείμενο video καθορίζει το βίντεο προς επέκταση (ένα url ή το file_id ενός μεταφορτωμένου αρχείου, για πηγή 2 έως 15 δευτερολέπτων) και το duration ορίζει το μήκος της επέκτασης μεταξύ 2 και 10 δευτερολέπτων—η προεπιλογή είναι 6 δευτερόλεπτα. Σε αντίθεση με την επεξεργασία, εδώ ανακτάτε τον έλεγχο της διάρκειας. Το επιστρεφόμενο βίντεο περιέχει το πρωτότυπο ακολουθούμενο από την επέκταση: μια πηγή 10 δευτερολέπτων που επεκτείνεται κατά 5 δευτερόλεπτα αποδίδει ένα βίντεο 15 δευτερολέπτων.

Ο παρακάτω πίνακας συνοψίζει τι διαχωρίζει τα δύο endpoints, καθώς η σύγχυση είναι συχνή.

ΠτυχήΕπεξεργασία (/edits)Επέκταση (/extensions)
ΣτόχοςΤροποποίηση περιεχομένουΠροσθήκη διάρκειας
Παράμετρος βίντεοΑντικείμενο video (url ή file_id)Αντικείμενο video (url ή file_id)
Διάρκεια πηγήςΜέγ. 8,7 δλ2 έως 15 δλ
Διάρκεια εξόδουΊδια με την πηγή (Μέγ. 720p)Πηγή + 2 έως 10 δλ
Αρχικό περιεχόμενοΤροποποιείΔιατηρεί

Και τα δύο endpoints του REST API λαμβάνουν το βίντεο με τον ίδιο τρόπο, σε ένα αντικείμενο video με την ιδιότητα url. Το Python SDK, ωστόσο, το δέχεται ως παράμετρο video_url: μην αντιγράφετε αυτό το όνομα παραμέτρου σε ένα σώμα JSON, καθώς το API δεν θα το αναγνωρίσει. Αυτό που πραγματικά διακρίνει τα δύο endpoints είναι η διάρκεια.

Τρεις τρόποι συνέχισης μιας σκηνής

Η απλούστερη περίπτωση consiste στο να αφήσετε αυτό που συμβαίνει ήδη να συνεχιστεί. Το prompt αναλαμβάνει την τρέχουσα δράση και την επεκτείνει χωρίς διακοπή.

{
  "model": "grok-imagine-video",
  "prompt": "The character continues walking along the beach, waves rolling gently",
  "video": {"url": "https://exemple.com/promenade.mp4"},
  "duration": 6
}

Μπορείτε επίσης να εισαγάγετε μια αλλαγή, φέρνοντας δηλαδή ένα νέο στοιχείο ή τροποποιώντας την κατεύθυνση της θέασης. Αυτό προσδίδει αφηγηματική πρόοδο στην ακολουθία.

{
  "model": "grok-imagine-video",
  "prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
  "video": {"url": "https://exemple.com/plage.mp4"},
  "duration": 8
}

Τρίτη περίπτωση χρήσης, το συμπέρασμα: μια σύντομη επέκταση που κλείνει καθαρά την ακολουθία, συχνά με σταδιακή εξασθένιση (fade).

{
  "model": "grok-imagine-video",
  "prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
  "video": {"url": "https://exemple.com/coucher-soleil.mp4"},
  "duration": 4
}

Αλυσιδωτή σύνδεση επεκτάσεων για τη δημιουργία μιας ακολουθίας

Τίποτα δεν εμποδίζει την επέκταση ενός βίντεο πολλές φορές διαδοχικά. Κάθε επέκταση παράγει ένα νέο βίντεο του οποίου το URL μπορεί να χρησιμεύσει ως πηγή για την επόμενη επέκταση, επιτρέποντάς σας να χτίσετε μια μακρά ακολουθία μέσω διαδοχικών τμημάτων, καθένα από τα οποία καθοδηγείται από το δικό του prompt. Το παρακάτω σενάριο αλυσιδώνει τρεις επεκτάσεις επανεισάγοντας το ληφθέν URL σε κάθε βήμα.

import httpx
import time

api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}

def attendre_video(request_id):
    """Poll status until completion."""
    while True:
        resp = httpx.get(
            f"https://api.x.ai/v1/videos/{request_id}",
            headers=headers
        ).json()
        if resp["status"] == "done":
            return resp["video"]["url"]
        if resp["status"] == "failed":
            raise RuntimeError(f"Generation failed: {resp.get('error')}")
        time.sleep(5)

# Base video
video_url = "https://exemple.com/video-initiale.mp4"

# Chain 3 extensions
prompts = [
    "The character crosses the bridge, profile view",
    "He stops in the middle and looks at the river below",
    "He resumes walking toward the other bank, the camera follows"
]

for prompt in prompts:
    resp = httpx.post(
        "https://api.x.ai/v1/videos/extensions",
        headers=headers,
        json={
            "model": "grok-imagine-video",
            "prompt": prompt,
            "video": {"url": video_url},
            "duration": 5
        }
    ).json()
    video_url = attendre_video(resp["request_id"])
    print(f"Extension complete: {video_url}")

Αυτή η κομψότητα έχει ένα τίμημα, κυριολεκτικά και μεταφορικά. Κάθε επέκταση χρεώνεται ξεχωριστά. Η πηγή δεν μπορεί να υπερβεί τα 15 δευτερόλεπτα, γεγονός που θέτει ένα όριο στην αλυσίδα: ξεκινώντας από 5 δευτερόλεπτα, η ακολουθία φτάνει τα 20 δευτερόλεπτα μετά από τρεις επεκτάσεις των 5 δευτερολέπτων και μια τέταρτη θα απορριφθεί. Η οπτική συνοχή υποβαθμίζεται across τους συνδέσμους, καθώς κάθε βήμα βασίζεται σε μια ήδη ερμηνευμένη έξοδο: πέρα από τρεις ή τέσσερις αλυσιδωτές επεκτάσεις, γίνονται ορατές αποκλίσεις στο χρώμα και τη μορφολογία. Και όπως παντού σε αυτό το API, τα URLs είναι προσωρινά—κατεβάστε κάθε ενδιάμεση έκδοση, διαφορετικά μια αποτυχία στο τέλος της αλυσίδας θα σας αναγκάσει να ξεκινήσετε από την αρχή.

Το δίδυμο δημιουργία και μετά επέκταση

Το πιο συνηθισμένο μοτίβο στην παραγωγή συνδυάζει και τα δύο endpoints. Αρχικά δημιουργείτε μια σύντομη βάση 3 δευτερολέπτων με ένα πολύ ακριβές prompt, μέσω του POST /v1/videos/generations, επιτρέποντάς σας να κάνετε επαναλήψεις στην αρχική αισθητική με χαμηλότερο κόστος. Στη συνέχεια προσθέτετε 5 δευτερόλεπτα ανάπτυξης μέσω του POST /v1/videos/extensions και έπειτα 4 δευτερόλεπτα συμπεράσματος μέσω μιας δεύτερης κλήσης στο ίδιο endpoint. Το αποτέλεσμα είναι ένα βίντεο 12 δευτερολέπτων χτισμένο τμήμα προς τμήμα, όπου κάθε μέρος επικυρώθηκε πριν ξεκινήσει το επόμενο—έλεγχος που καμία ενιαία δημιουργία 12 δευτερολέπτων δεν θα προσέφερε.

Βασικά σημεία

  • Η επέκταση επιμηκύνει ένα βίντεο 2 έως 15 δευτερολέπτων κατά ένα τμήμα 2 έως 10 δευτερολέπτων (προεπιλογή 6) και επιστρέφει το πλήρες βίντεο
  • Το βίντεο πηγής τοποθετείται σε ένα αντικείμενο video (url ή file_id), όπως στην επεξεργασία· το Python SDK το δέχεται ως video_url
  • Η αλυσιδωτή σύνδεση επιτρέπει τη δημιουργία μακρών ακολουθιών βήμα προς βήμα
  • Η συνοχή υποβαθμίζεται πέρα από 3-4 διαδοχικές επεκτάσεις
  • Συνδυάστε την αρχική δημιουργία με επεκτάσεις για ακριβή έλεγχο του περιεχομένου