UlazAI fejlesztői dokumentumok
Sora 2 API: videó generálás, árazás és hozzáférés
Sora 2 API: videó generálás, árazás és hozzáférés
Generáljon Sora 2 videókat a UlazAI segítségével egyértelmű végpontokkal, hitelárakkal, prompt szabályokkal, állapotlekérdezéssel és CDN kimenet kezeléssel.
Generálás előtt ellenőrizze az aktuális Sora modell árát és az aktív fiók ajánlatait.
✨ Sora 2 jellemzők
✅ Szövegből videóba generáció
✅ Képről videóra animáció
✅ Időtartam opciók az aktuális API útvonal mutatja
✅ Kimeneti beállítások az aktuális API dokumentációban látható
✅ Támogatott képarányok a kiválasztott útvonaltól függ
✅ Aszinkron feldolgozás állapotlekérdezéssel
✅ Automatikus R2 tároló CDN-nel
✅ E-mail értesítések ha kész
/api/v1/sora/generate/text-to-video/
Videó létrehozása szövegből
Hozzon létre egy 10 másodperces videót szöveges promptból a Sora 2 használatával.
Kérelem szerve
{
"prompt": "A serene mountain landscape at sunrise with birds flying",
"aspect_ratio": "landscape", // Options: "landscape", "portrait", "square"
"quality": "standard" // Options: "standard", "high"
}
Paraméterek
prompt * (karakterlánc)
A generálandó videó szöveges leírása. Max 5000 karakter. A legjobb eredmény érdekében legyen leíró jellegű.
aspect_ratio (karakterlánc)
Videó képaránya. Opciók: landscape (16:9), portrait (9:16), square (1:1). Alapértelmezett: landscape
minőség (karakterlánc)
Minőségi előre beállított. Opciók: standard, high. A jó minőség több feldolgozási időt igényel. Alapértelmezett: standard
prompt_directory_optin (boolean) 💰 -10 KREDIT
Oszd meg videódat nyilvános Prompt címtárunkban, és szerezd be 10 kredit kedvezmény! Alapértelmezett: true
Sikerreakció (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 példa
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/
Videó létrehozása a képből
Animálj statikus képet 10 másodperces videóvá a Sora 2 használatával.
Kérelem szerve
{
"image_url": "https://example.com/your-image.jpg",
"prompt": "Camera slowly zooms in as the character turns and smiles",
"aspect_ratio": "landscape",
"quality": "standard"
}
Paraméterek
image_url * (karakterlánc)
Az animálni kívánt forráskép URL-je. Nyilvánosan hozzáférhetőnek kell lennie. Támogatott formátumok: JPG, PNG, WebP.
prompt * (karakterlánc)
A kép animálásának leírása. Max 5000 karakter.
aspect_ratio (karakterlánc)
A legjobb eredmény érdekében meg kell egyeznie a forrás képarányával.
minőség (karakterlánc)
Minőségi előre beállított. Alapértelmezett: standard
prompt_directory_optin (boolean) 💰 -10 KREDIT
Oszd meg videódat nyilvános Prompt címtárunkban, és szerezd be 10 kredit kedvezmény! Alapértelmezett: true
/api/v1/sora/status/{task_id}/
Ellenőrizze a Generációs állapotot
Szerezze meg a Sora videógenerálási feladat aktuális állapotát és eredményét.
Válaszállapotok
Feldolgozás
{
"success": true,
"data": {
"task_id": "sra_2_1234567890abcdef",
"status": "processing",
"progress": 45,
"estimated_completion": "varies by queue"
}
}
Siker
{
"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"
}
}
Sikertelen
{
"success": false,
"error": "Video generation failed",
"error_details": "Content policy violation detected in prompt",
"credits_refunded": 80
}
cURL példa
curl -X GET https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/ \
-H "Authorization: Token YOUR_API_KEY"
🔑 Sora 2 API hozzáférés: hivatalos vs UlazAI
Sora 2 API hozzáférés a szolgáltatótól, a szervezet ellenőrzésétől és a fiókszinttől függ. Az integráció előtt ellenőrizze az aktuális hozzáférést és az árakat.
Hivatalos OpenAI API
- Meghívás / szervezet-ellenőrzés zárva
- Videó másodpercenként számlázva
- Ön kezelheti saját OpenAI kulcsát és kvótáját
Sora 2 a UlazAI-n
- Hívja most egyetlen UlazAI API kulccsal – külön meghívó nélkül
- Ára megosztott kreditben, visszatérítés a sikertelen munkák esetén
- Ugyanez a kulcs hívja a Veo 3, a Seedance és a Kling billentyűket is – hasonlítsa össze a költségeket és a késleltetést egyetlen egyenlegről
Szeretné először mérlegelni a Sora 2-t az alternatívákkal szemben? Lásd a 2026-os AI videómodellek útmutatója.
💰 Sora 2 árak
Szövegből videóba
Ellenőrizze a jelenlegi API árat
a kiválasztott időtartamra és modellre
• Ellenőrizze az aktuális kimeneti beállításokat
• Ellenőrizze a támogatott képarányokat
• A feldolgozási idő soronként változik
Képről videóra
Ellenőrizze a jelenlegi API árat
képről videóra
• Töltsön fel egy támogatott képet, amelyet használhat
• Egyedi mozgás prompts
• A feldolgozási idő soronként változik
Számítsa ki a tételt a modell aktuális költségéből és a várható újrapróbálkozási arányból.
📚 A legjobb gyakorlatok
Prompt Irányelvek
- Legyen határozott a kamera mozgásával kapcsolatban (pásztázás, zoom, döntés)
- Ismertesse a világítást és a légkört
- Tartalmazza a karakter cselekvéseit és kifejezéseit
- Adja meg a kulcsfontosságú pillanatok időzítését
- Kerülje a szerzői joggal védett karaktereket vagy márkákat
Kép-videó tippek
- Kiváló minőségű forrásképek használata (min 1024 képpont)
- Egyezzen meg a képarányt a kivágás elkerülése érdekében
- Írja le a jelenet valósághű mozgását
- Vegye figyelembe a fizikát és a természetes mozgást
Webhook integráció
- A videók automatikusan R2-ben tárolódnak CDN-kézbesítéssel
- A generálás befejezésekor e-mail értesítést küldünk
- Frissítésekért 30 másodpercenként kérje le az állapotvégpontot
- A sikertelen generációk automatikusan visszatérítik a jóváírásokat
⚠️ Hibakódok
400
Érvénytelen kérési paraméterek vagy túl hosszú a prompt
401
Érvénytelen vagy hiányzó API kulcs
402
Elégtelen kredit
422
Tartalmi irányelvek megsértése
429
Túllépte a sebességkorlátot (maximum 10 egyidejűleg)
500
Szerverhiba – a jóváírásokat visszatérítjük
💻 Kódpéldák
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();
🚀 Kezdésre készen állsz?
Ellenőrizze fiókjában az aktuális hitelajánlatokat.