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

Επεξεργασία βίντεο με το /v1/videos/edits

Μάθημα 7 / 12 Ενημερώθηκε 3 Νοεμβρίου 2026 Μέσου επιπέδου
Σε αυτήν τη σελίδα
  1. Επεξεργασία υπάρχοντος βίντεο
  2. Το σημείο τέλους POST /v1/videos/edits
  3. Τι να ζητήσετε σε μια επεξεργασία
  4. Ο ασύγχρονος κύκλος, ίδιος με τη δημιουργία
  5. Δηλώστε τι αλλάζει και τι παραμένει
  6. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση τη σελίδα Video Editing της xAI: η πηγαία βιντεοσκόπηση έχει μέγιστη διάρκεια 8,7 δευτερόλεπτα, η έξοδος διατηρεί τη διάρκεια, την αναλογία διαστάσεων και την ανάλυσή της (μέγιστο 720p), ενώ η επέκταση χρησιμοποιεί το ίδιο αντικείμενο video με την επεξεργασία. Ο προηγούμενος ισχυρισμός ότι η επεξεργασία ήταν αναξιόπιστη για συγκεκριμένα στοιχεία αντικρούεται από τα παραδείγματα της xAI, τα οποία εστιάζουν ακριβώς σε ακριβείς επεμβάσεις. Πηγές: Video Editing · Video Overview.

Επεξεργασία υπάρχοντος βίντεο

Η δημιουργία αποτελεί μόνο μέρος της εργασίας. Το API της xAI διαθέτει επίσης ένα σημείο τέλους επεξεργασίας βίντεο που λαμβάνει μια υπάρχουσα ακολουθία και την τροποποιεί βάσει προτροπών κειμένου. Πρόκειται για το ισοδύναμο της επεξεργασίας εικόνων στον χώρο του βίντεο, με αυστηρότερους περιορισμούς μορφής. Πριν γράψετε το πρώτο σας αίτημα, λάβετε υπόψη τα τέσσερα όρια που καθορίζουν τι μπορείτε να υποβάλετε.

8.7 s
Μέγιστη διάρκεια πηγής
720p
Μέγιστη ανάλυση
H.265
Αποδεκτός κωδικοποιητής (όπως H.264, AV1)
MP4
Απαιτούμενη μορφή

Το σημείο τέλους POST /v1/videos/edits

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

{
  "model": "grok-imagine-video",
  "prompt": "Change the background to a sunset over the ocean",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Αρκούν τρία πεδία: το model, το οποίο παραμένει grok-imagine-video· το prompt, το οποίο περιέχει την περιγραφή της τροποποίησης· και το video.url, το οποίο δείχνει στο αρχείο MP4 προς επεξεργασία. Παρατηρήστε ότι το βίντεο περικλείεται σε ένα αντικείμενο video, το οποίο δέχεται είτε ένα url είτε το file_id ενός μεταφορτωμένου αρχείου: το σημείο τέλους επέκτασης, στο επόμενο μάθημα, υιοθετεί την ίδια σύμβαση.

Οι τεχνικοί περιορισμοί είναι εδώ αυστηρότεροι από ό,τι στη δημιουργία. Η πηγή δεν πρέπει να υπερβαίνει τα 8,7 δευτερόλεπτα και το παραγόμενο βίντεο διατηρεί τη διάρκειά του· η σελίδα Video Generation αναφέρει διάρκεια «περιορισμένη στα 8,7 δευτερόλεπτα» χωρίς να λεπτομερεί τον χειρισμό μεγαλύτερης πηγής: επομένως, περικόψτε τις πηγές σας εκ των προτέρων. Η ανάλυση περιορίζεται στα 720p. Το αρχείο εισόδου πρέπει να είναι MP4 σε υποστηριζόμενο κωδικοποιητή, όπως H.264, H.265 ή AV1. Το πιο συγχυτικό σημείο για όσους έρχονται από τη δημιουργία: δεν έχετε κανέναν έλεγχο επί της διάρκειας, της αναλογίας διαστάσεων ή της ανάλυσης της εξόδου, καθώς όλα καθορίζονται από το βίντεο προέλευσης. Το αίτημα επεξεργασίας δεν περιλαμβάνει κανένα πεδίο duration, aspect_ratio ή resolution.

Τι να ζητήσετε σε μια επεξεργασία

Η αντικατάσταση φόντου είναι η κλασική περίπτωση: το θέμα παραμένει, το σκηνικό αλλάζει.

{
  "model": "grok-imagine-video",
  "prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
  "video": {"url": "https://example.com/video.mp4"}
}

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

{
  "model": "grok-imagine-video",
  "prompt": "Transform this video into a Japanese cartoon style with vivid colors",
  "video": {"url": "https://example.com/video.mp4"}
}

Η προσθήκη στοιχείων εμπλουτίζει τη σκηνή με στρώματα που δεν υπήρχαν κατά τη διάρκεια της λήψης, συνήθως ατμοσφαιρικά.

{
  "model": "grok-imagine-video",
  "prompt": "Add falling snow and a frost effect on the edges",
  "video": {"url": "https://example.com/video.mp4"}
}

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

{
  "model": "grok-imagine-video",
  "prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
  "video": {"url": "https://example.com/video.mp4"}
}

Ο ασύγχρονος κύκλος, ίδιος με τη δημιουργία

Η επεξεργασία ακολουθεί ακριβώς το ίδιο πρωτόκολλο τεσσάρων βημάτων με τη δημιουργία: στέλνετε το αίτημα, λαμβάνετε ένα request_id, κάνετε polling στο GET /v1/videos/{request_id} σε τακτά διαστήματα και ανακτάτε το επεξεργασμένο βίντεο όταν η κατάσταση αλλάξει σε done. Στην Python, τα δύο πρώτα βήματα χωρούν σε λίγες γραμμές.

import httpx

# 1. Υποβολή της επεξεργασίας
response = httpx.post(
    "https://api.x.ai/v1/videos/edits",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "grok-imagine-video",
        "prompt": "Add a rain effect over the entire scene",
        "video": {"url": "https://example.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

# 2. Polling της κατάστασης (απλοποιημένο)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Δηλώστε τι αλλάζει και τι παραμένει

Η xAI περιγράφει τη συμπεριφορά του μοντέλου σε μία πρόταση: το grok-imagine-video εφαρμόζει την ζητούμενη αλλαγή και διατηρεί τα πάντα όσο το δυνατόν πιο κοντά στην πηγή. Η τεκμηρίωσή της εξάγει από αυτό μια κατευθυντήρια γραμμή: πείτε επίσης τι πρέπει να παραμείνει ίδιο. Τα δικά της παραδείγματα εστιάζουν επίσης σε ακριβείς επεμβάσεις σε ένα μόνο κλιπ—προσθήκη ασημένιου περιδέραιου, αλλαγή ενδυμασίας σε κόκκινο, τοποθέτηση μαύρου πλατύγυρου καπέλου σε έναν χαρακτήρα—που εκτελούνται παράλληλα στην ίδια πηγή.

{
  "model": "grok-imagine-video",
  "prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
  "video": {"url": "https://example.com/video.mp4"}
}

Ο οδηγός προτροπών εικόνων της xAI, γραμμένος για στατικές εικόνες, καθορίζει τη σειρά που λειτουργεί: πρώτα η τροποποίηση και μετά μια πρόταση που κλειδώνει ό,τι παραμένει στατικό. Μια επεξεργασία που ξεκινά με «διατήρησε τα πάντα» αλλάζει σχεδόν τίποτα, ενώ μια επεξεργασία που αντιγράφει μια πλήρη προτροπή δημιουργίας επινοεί εκ νέου τη σκηνή.

Τέσσερις συνήθειες αποτρέπουν τις περισσότερες παγίδες: διατηρήστε τις πηγές σας κάτω από 8,7 δευτερόλεπτα, σε υποστηριζόμενο κωδικοποιητή (H.264, H.265 ή AV1)· ονομάστε τι πρέπει να παραμείνει άθικτο· δοκιμάστε μια τροποποίηση σε ένα σύντομο κλιπ πριν την κλιμακώσετε· και θυμηθείτε ότι η επεξεργασία χρησιμοποιεί το grok-imagine-video, του οποίου ο τιμοκατάλογος δείχνει μια ενιαία χρέωση, 0,050 $ ανά δευτερόλεπτο—ένας γύρος δοκιμών κοστίζει το ίδιο με τη δημιουργία.

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

  • Το σημείο τέλους POST /v1/videos/edits τροποποιεί ένα υπάρχον βίντεο βάσει μιας προτροπής, αποκλειστικά με το grok-imagine-video
  • Η πηγή διαρκεί το πολύ 8,7 δευτερόλεπτα· η έξοδος διατηρεί τη διάρκεια, την αναλογία και την ανάλυσή της (μέγιστο 720p)
  • Το βίντεο προέλευσης πρέπει να είναι MP4 σε υποστηριζόμενο κωδικοποιητή (H.264, H.265, AV1)
  • Το αίτημα δεν διαθέτει πεδία duration, aspect_ratio ή resolution
  • Πείτε τι πρέπει να αλλάξει και μετά τι πρέπει να παραμείνει ίδιο