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

Έγγραφα προγραμματιστή UlazAI

Sora 2 API: δημιουργία βίντεο, τιμολόγηση και πρόσβαση

Sora 2 API: δημιουργία βίντεο, τιμολόγηση και πρόσβαση

Δημιουργήστε βίντεο Sora 2 μέσω του UlazAI με σαφή τελικά σημεία, τιμολόγηση πίστωσης, κανόνες prompt, δημοσκόπηση κατάστασης και διαχείριση εξόδου CDN.

Ελέγξτε την τρέχουσα τιμή μοντέλου Sora και οποιαδήποτε προσφορά ενεργού λογαριασμού πριν από τη δημιουργία.

✨ Χαρακτηριστικά Sora 2

✅ Κείμενο σε βίντεο γενιά

✅ Εικόνα σε βίντεο κινούμενα σχέδια

✅ Επιλογές διάρκειας φαίνεται από την τρέχουσα διαδρομή API

✅ Ρυθμίσεις εξόδου εμφανίζεται στην τρέχουσα τεκμηρίωση API

✅ Υποστηριζόμενες αναλογίες διαστάσεων εξαρτώνται από την επιλεγμένη διαδρομή

✅ Ασύγχρονη επεξεργασία με δημοσκόπηση κατάστασης

✅ Αυτόματη αποθήκευση R2 με CDN

✅ Ειδοποιήσεις μέσω email όταν ολοκληρωθεί

ΑΝΑΡΤΗΣΗ /api/v1/sora/generate/text-to-video/

Δημιουργία βίντεο από κείμενο

Δημιουργήστε ένα βίντεο 10 δευτερολέπτων από ένα κείμενο prompt χρησιμοποιώντας το Sora 2.

Σώμα αιτήματος

{
  "prompt": "A serene mountain landscape at sunrise with birds flying",
  "aspect_ratio": "landscape",  // Options: "landscape", "portrait", "square"
  "quality": "standard"          // Options: "standard", "high"
}

Παράμετροι

prompt * (χορδή)

Περιγραφή κειμένου του βίντεο προς δημιουργία. Έως 5000 χαρακτήρες. Να είστε περιγραφικοί για καλύτερα αποτελέσματα.

aspect_ratio (χορδή)

Αναλογία διαστάσεων βίντεο. Επιλογές: landscape (16:9), portrait (9:16), square (1:1). Προεπιλογή: landscape

ποιότητα (χορδή)

Προκαθορισμένη ποιότητα. Επιλογές: standard, high. Η υψηλή ποιότητα χρησιμοποιεί περισσότερο χρόνο επεξεργασίας. Προεπιλογή: standard

prompt_directory_optin (Boolean) 💰 -10 ΠΙΣΤΩΣΕΙΣ

Μοιραστείτε το βίντεό σας στον δημόσιο κατάλογο Prompt και αποκτήστε Έκπτωση 10 πιστώσεων! Προεπιλογή: true

Απόκριση επιτυχίας (201)

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "processing",
    "estimated_completion": "varies by queue",
    "credits_charged": 80,
    "credits_remaining": 920,
    "webhook_url": "https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/",
    "message": "Sora 2 video generation started successfully"
  }
}

Παράδειγμα cURL

curl -X POST https://ulazai.com/api/v1/sora/generate/text-to-video/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunrise with birds flying across the sky",
    "aspect_ratio": "landscape",
    "quality": "standard"
  }'
ΑΝΑΡΤΗΣΗ /api/v1/sora/generate/image-to-video/

Δημιουργία βίντεο από εικόνα

Μετακινήστε μια στατική εικόνα σε ένα βίντεο 10 δευτερολέπτων χρησιμοποιώντας το Sora 2.

Σώμα αιτήματος

{
  "image_url": "https://example.com/your-image.jpg",
  "prompt": "Camera slowly zooms in as the character turns and smiles",
  "aspect_ratio": "landscape",
  "quality": "standard"
}

Παράμετροι

image_url * (χορδή)

URL της εικόνας πηγής για κίνηση. Πρέπει να είναι δημόσια προσβάσιμη. Υποστηριζόμενες μορφές: JPG, PNG, WebP.

prompt * (χορδή)

Περιγραφή του τρόπου δημιουργίας κινούμενων εικόνων. Έως 5000 χαρακτήρες.

aspect_ratio (χορδή)

Πρέπει να ταιριάζει με την αναλογία εικόνας πηγής για καλύτερα αποτελέσματα.

ποιότητα (χορδή)

Προκαθορισμένη ποιότητα. Προεπιλογή: standard

prompt_directory_optin (Boolean) 💰 -10 ΠΙΣΤΩΣΕΙΣ

Μοιραστείτε το βίντεό σας στον δημόσιο κατάλογο Prompt και αποκτήστε Έκπτωση 10 πιστώσεων! Προεπιλογή: true

ΠΑΡΕ /api/v1/sora/status/{task_id}/

Ελέγξτε την κατάσταση δημιουργίας

Λάβετε την τρέχουσα κατάσταση και το αποτέλεσμα μιας εργασίας δημιουργίας βίντεο Sora.

Κράτη απόκρισης

Επεξεργασία

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "processing",
    "progress": 45,
    "estimated_completion": "varies by queue"
  }
}

Επιτυχία

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "success",
    "video_url": "https://cdn.ulazai.com/sora/videos/sra_2_1234567890abcdef.mp4",
    "thumbnail_url": "https://cdn.ulazai.com/sora/thumbnails/sra_2_1234567890abcdef.jpg",
    "duration": 10,
    "resolution": "1920x1080",
    "file_size": "15.2 MB",
    "created_at": "2025-01-03T10:15:30Z"
  }
}

Αποτυχημένος

{
  "success": false,
  "error": "Video generation failed",
  "error_details": "Content policy violation detected in prompt",
  "credits_refunded": 80
}

Παράδειγμα cURL

curl -X GET https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/ \
  -H "Authorization: Token YOUR_API_KEY"

🔑 Sora 2 API πρόσβαση: επίσημη εναντίον UlazAI

Πρόσβαση Sora 2 API εξαρτάται από τον πάροχο, την επαλήθευση του οργανισμού και το επίπεδο λογαριασμού. Επαληθεύστε την τρέχουσα πρόσβαση και την τιμολόγηση πριν από την ενσωμάτωση.

Επίσημο OpenAI API

  • Πρόσκληση / οργάνωση-επαλήθευση κλειστή
  • Χρέωση ανά δευτερόλεπτο βίντεο
  • Διαχειρίζεστε το δικό σας κλειδί OpenAI και τα μερίδια

Sora 2 σε UlazAI

  • Καλέστε το τώρα με ένα κλειδί UlazAI API - χωρίς ξεχωριστή πρόσκληση
  • Τιμές σε κοινόχρηστες πιστώσεις, επιστρέφονται για αποτυχημένες εργασίες
  • Το ίδιο κλειδί καλεί επίσης τα Veo 3, Seedance και Kling - συγκρίνετε το κόστος και την καθυστέρηση από ένα υπόλοιπο

Θέλετε να ζυγίσετε πρώτα το Sora 2 με τις εναλλακτικές; Δείτε το Οδηγός μοντέλων βίντεο AI 2026.

💰 Τιμές Sora 2

Κείμενο σε βίντεο

Ελέγξτε την τρέχουσα τιμή API

για την επιλεγμένη διάρκεια και μοντέλο

• Ελέγξτε τις τρέχουσες ρυθμίσεις εξόδου

• Ελέγξτε τις υποστηριζόμενες αναλογίες διαστάσεων

• Ο χρόνος επεξεργασίας ποικίλλει ανάλογα με την ουρά

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

Ελέγξτε την τρέχουσα τιμή API

για εικόνα σε βίντεο

• Μεταφορτώστε μια υποστηριζόμενη εικόνα που μπορείτε να χρησιμοποιήσετε

• Προσαρμοσμένη κίνηση prompts

• Ο χρόνος επεξεργασίας ποικίλλει ανάλογα με την ουρά

Υπολογίστε την παρτίδα σας από το τρέχον κόστος μοντέλου και το αναμενόμενο ποσοστό επανάληψης.

📚 Βέλτιστες πρακτικές

Οδηγίες Prompt

  • Να είστε συγκεκριμένοι σχετικά με τις κινήσεις της κάμερας (pan, zoom, tilt)
  • Περιγράψτε τον φωτισμό και την ατμόσφαιρα
  • Συμπεριλάβετε ενέργειες και εκφράσεις χαρακτήρων
  • Καθορίστε το χρονοδιάγραμμα για τις βασικές στιγμές
  • Αποφύγετε χαρακτήρες ή επωνυμίες που προστατεύονται από πνευματικά δικαιώματα

Συμβουλές εικόνας σε βίντεο

  • Χρησιμοποιήστε εικόνες πηγής υψηλής ποιότητας (ελάχ. 1024 εικονοστοιχεία)
  • Αντιστοίχιση αναλογίας διαστάσεων για αποφυγή περικοπής
  • Περιγράψτε ρεαλιστική κίνηση για τη σκηνή
  • Σκεφτείτε τη φυσική και τη φυσική κίνηση

Ενσωμάτωση Webhook

  • Τα βίντεο αποθηκεύονται αυτόματα στο R2 με παράδοση CDN
  • Οι ειδοποιήσεις μέσω email αποστέλλονται όταν ολοκληρωθεί η δημιουργία
  • Ελέγχετε το τελικό σημείο κατάστασης κάθε 30 δευτερόλεπτα για ενημερώσεις
  • Οι γενιές που απέτυχαν επιστρέφουν αυτόματα τις πιστώσεις

⚠️ Κωδικοί σφαλμάτων

400 Μη έγκυρες παράμετροι αιτήματος ή πολύ μεγάλο prompt
401 Το κλειδί API δεν είναι έγκυρο ή λείπει
402 Ανεπαρκείς πιστώσεις
422 Παράβαση πολιτικής περιεχομένου
429 Υπέρβαση του ορίου ποσοστού (μέγιστο 10 ταυτόχρονα)
500 Σφάλμα διακομιστή - οι πιστώσεις θα επιστραφούν

💻 Παραδείγματα κωδικών

Python

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://ulazai.com/api/v1"

# Generate video
response = requests.post(
    f"{BASE_URL}/sora/generate/text-to-video/",
    headers={"Authorization": f"Token {API_KEY}"},
    json={
        "prompt": "A beautiful sunset over the ocean with waves",
        "aspect_ratio": "landscape",
        "quality": "standard"
    }
)

if response.status_code == 201:
    task_id = response.json()["data"]["task_id"]

    # Poll for status
    while True:
        status_response = requests.get(
            f"{BASE_URL}/sora/status/{task_id}/",
            headers={"Authorization": f"Token {API_KEY}"}
        )

        status_data = status_response.json()["data"]

        if status_data["status"] == "success":
            print(f"Video ready: {status_data['video_url']}")
            break
        elif status_data["status"] == "failed":
            print("Generation failed")
            break

        time.sleep(30)  # Wait 30 seconds before next check

Javascript (node.js)

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://ulazai.com/api/v1';

async function generateSoraVideo() {
    try {
        // Generate video
        const response = await axios.post(
            `${BASE_URL}/sora/generate/text-to-video/`,
            {
                prompt: 'A beautiful sunset over the ocean with waves',
                aspect_ratio: 'landscape',
                quality: 'standard'
            },
            {
                headers: { 'Authorization': `Token ${API_KEY}` }
            }
        );

        const taskId = response.data.data.task_id;
        console.log(`Generation started: ${taskId}`);

        // Poll for status
        const checkStatus = async () => {
            const statusResponse = await axios.get(
                `${BASE_URL}/sora/status/${taskId}/`,
                { headers: { 'Authorization': `Token ${API_KEY}` } }
            );

            const status = statusResponse.data.data.status;

            if (status === 'success') {
                console.log(`Video ready: ${statusResponse.data.data.video_url}`);
            } else if (status === 'failed') {
                console.log('Generation failed');
            } else {
                setTimeout(checkStatus, 30000); // Check again in 30 seconds
            }
        };

        setTimeout(checkStatus, 30000);

    } catch (error) {
        console.error('Error:', error.response?.data || error.message);
    }
}

generateSoraVideo();

🚀 Είστε έτοιμοι να ξεκινήσετε;

Ελέγξτε τον λογαριασμό σας για τρέχουσες προσφορές πίστωσης.