Έγγραφα UlazAI

Εικόνα και βίντεο APIs

Στούντιο βίντεο API

Τιμολόγηση Ταμπλό Στούντιο εικόνας

ΑΝΑΡΤΗΣΗ /api/v1/video-studio/generate/

Κανονικό τελικό σημείο δημιουργίας βίντεο

Χρησιμοποιήστε το Video Studio για όλα τα τρέχοντα μοντέλα βίντεο. Αυτό το τελικό σημείο υποστηρίζει κείμενο σε βίντεο, εικόνα σε βίντεο και ροές εργασίας για συγκεκριμένο μοντέλο, όπως remix βίντεο.

Για δυναμικές ενσωματώσεις, ανακτήστε τις δυνατότητες του μοντέλου από /api/v1/models/video/ πριν από την αποστολή ωφέλιμων φορτίων παραγωγής.

Οι πρόσφατες διαδρομές Video Studio περιλαμβάνουν seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v, και happyhorse_videoedit.

Έλεγχος ταυτότητας: αποστολή Authorization: Bearer YOUR_API_KEY σε κάθε αίτημα.

Δημοσκόπηση με /api/v1/video-studio/status/{job_id}/ και φορτώστε πρόσφατα θέσεις εργασίας από /api/v1/video-studio/history/.

Ζητήστε συμβόλαιο

Πεδίο	Τύπος	Απαιτείται	Σημειώσεις
`model_slug`	χορδή	Ναι	Πρέπει να ταιριάζει με ένα εγγεγραμμένο μοντέλο γυμνοσάλιαγκας Video Studio
`prompt`	χορδή	Συνήθως	Απαιτείται για τα περισσότερα μοντέλα. Η λειτουργία Storyboard μπορεί να ξεκινήσει μόνο με εικόνες.
`aspect_ratio`	χορδή	Όχι	Πρέπει να είναι ένας από τους λόγους διαστάσεων του επιλεγμένου μοντέλου
`duration_seconds`	ακέραιος αριθμός	Όχι	Πρέπει να αντιστοιχεί σε μια επιτρεπόμενη διάρκεια για το μοντέλο. Το Motion Control χρησιμοποιεί το μήκος του κλιπ κίνησης για την τιμολόγηση.
`quality_mode`	χορδή	Όχι	Απαιτείται όταν το μοντέλο ορίζει τρόπους ποιότητας
`input_image_urls`	πίνακας[string]	Ειδικά για το μοντέλο	Χρησιμοποιείται για μοντέλα εικόνας σε βίντεο. Ορισμένα μοντέλα απαιτούν τουλάχιστον μία διεύθυνση URL.
`input_video_urls`	πίνακας[string]	Ειδικά για το μοντέλο	Χρησιμοποιείται από remix βίντεο και διαδρομές πηγής-βίντεο όπως π.χ `wan_2_6_v2v`, `kling_3_0_motion_control`, `video_lip_sync`, και `happyhorse_videoedit`.
`seedance_mode`	χορδή	Seedance 2 μόνο	Χρήση `text_to_video`, `first_frame`, `first_last_frame`, ή `multimodal`.
`first_frame_url`, `last_frame_url`	χορδή	Seedance 2 μόνο	Χρησιμοποιήστε το για τις λειτουργίες πρώτου καρέ και πρώτου+τελευταίου καρέ Seedance 2. Δημόσιες διευθύνσεις URL και `asset://` Ταυτότητες γίνονται δεκτές.
`reference_image_urls`, `reference_video_urls`, `reference_audio_urls`	πίνακας[string]	Ειδικά για το μοντέλο	Το Seedance 2 χρησιμοποιεί πολυτροπικές συστοιχίες αναφοράς. Ηχητικές διαδρομές όπως `video_lip_sync` και `omnihuman_1_5` χρήση `reference_audio_urls` για την ομιλία-στόχο ή τη φωνή. Δημόσιες διευθύνσεις URL και `asset://` Τα αναγνωριστικά γίνονται δεκτά όπου το επιλεγμένο μοντέλο τα υποστηρίζει.
`character_orientation`	χορδή	Ειδικά για το μοντέλο	Μόνο Έλεγχος κίνησης. Χρήση `video` για να ακολουθήσετε τον προσανατολισμό του κλιπ κίνησης ή `image` για να διατηρήσετε το καδράρισμα των μεταφορτωμένων χαρακτήρων, με διάρκεια από 3 έως 15 δευτερόλεπτα.
`sound`	boolean	Όχι	Χρησιμοποιείται μόνο σε μοντέλα με υποστήριξη ήχου
`return_last_frame`, `web_search`	boolean	Seedance 2 μόνο	Προαιρετικές σημαίες Seedance 2 για την επιστροφή του τελευταίου πλαισίου και την ενεργοποίηση της αναζήτησης ιστού από την πλευρά του μοντέλου.
`prompt_directory_optin`	boolean	Όχι	Η έκπτωση καταλόγου ισχύει μόνο για επιλεγμένες οικογένειες μοντέλων

Για πλάνα πραγματικού προσώπου στο Seedance 2, χρησιμοποιήστε το Οδηγός στοιχείων UlazAI Seedance 2 και περάστε το επιστρεφόμενο asset:// ID. Τα απευθείας ακατέργαστα αρχεία ενδέχεται να αποτύχουν.

Επιλογέας μοντέλου

Επιλέξτε ένα μοντέλο για να επιθεωρήσετε τις δυνατότητες και να δημιουργήσετε αυτόματα αποσπάσματα αιτημάτων.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

Κινητήρας: Seedance 2.5

Αναλογίες διαστάσεων: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Διάρκεια: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 δευτερόλεπτα

Λειτουργίες ποιότητας: 480p, 720p, 1080p

Είσοδοι: κείμενο , εικόνα , βίντεο

Πιστώσεις: 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 more

Ζωντανά αποσπάσματα αιτημάτων

Τα παρακάτω αποσπάσματα ακολουθούν την προεπιλογή του επιλεγμένου μοντέλου.

cURL (κλειδί API)

JavaScript (ανάκτηση)

Python (αιτήματα)

Αποσπάσματα δημοσκόπησης κατάστασης

Κατάσταση δημοσκόπησης από job_id έως ότου completed ή failed.

ΚΟΥΡΛ

JavaScript (ανάκτηση)

Python (αιτήματα)

Παραδείγματα ανταπόκρισης

Επιτυχία

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Σφάλμα επικύρωσης

{
  "success": false,
  "error": "Invalid duration for this model"
}

Ανεπαρκείς πιστώσεις

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

Τελικό σημείο βίντεο κλειδιού API (παλαιού τύπου)

Εάν χρειάζεστε βιντεοκλήσεις βασισμένες σε κλειδί API, χρησιμοποιήστε το /api/v1/generate/video/. Αυτό το μονοπάτι υποστηρίζει α περιορισμένο σύνολο μοντέλων και τεκμηριώνεται στην αντιστοίχιση βίντεο παλαιού τύπου.

Ανοίξτε τη χαρτογράφηση βίντεο παλαιού τύπου Άνοιγμα ροών εργασιών κατάστασης Ανοίξτε τη μήτρα μοντέλου βίντεο