UlazAI utviklerdokumenter
Sora 2 API: videogenerering, priser og tilgang
Sora 2 API: videogenerering, priser og tilgang
Generer Sora 2-videoer gjennom UlazAI med klare endepunkter, kredittprising, spørsmålsregler, statuspolling og CDN-utdatahåndtering.
Sjekk gjeldende Sora-modellpris og eventuelle aktive kontotilbud før generering.
✨ Sora 2-funksjoner
✅ Tekst-til-video generasjon
✅ Bilde-til-video animasjon
✅ Varighetsalternativer vist av gjeldende API-rute
✅ Utgangsinnstillinger vist i gjeldende API-dokumentasjon
✅ Støttet sideforhold avhenger av den valgte ruten
✅ Asynkron prosessering med statusmåling
✅ Automatisk R2-lagring med CDN
✅ E-postvarsler når ferdig
/api/v1/sora/generate/text-to-video/
Generer video fra tekst
Lag en 10-sekunders video fra en tekstmelding ved å bruke Sora 2.
Forespørselsorgan
{
"prompt": "A serene mountain landscape at sunrise with birds flying",
"aspect_ratio": "landscape", // Options: "landscape", "portrait", "square"
"quality": "standard" // Options: "standard", "high"
}
Parametere
prompt * (streng)
Tekstbeskrivelse av videoen som skal genereres. Maks 5000 tegn. Vær beskrivende for best resultat.
aspect_ratio (streng)
Videosideforhold. Alternativer: landscape (16:9), portrait (9:16), square (1:1). Standard: landscape
kvalitet (streng)
Forhåndsinnstilt kvalitet. Alternativer: standard, high. Høy kvalitet bruker mer behandlingstid. Standard: standard
prompt_directory_optin (boolsk) 💰 -10 KREDITTER
Del videoen din til vår offentlige promptkatalog og få 10 kreditter rabatt! Standard: true
Suksessrespons (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"
}
}
Eksempel på 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/
Generer video fra bilde
Animer et statisk bilde til en 10-sekunders video ved hjelp av Sora 2.
Forespørselsorgan
{
"image_url": "https://example.com/your-image.jpg",
"prompt": "Camera slowly zooms in as the character turns and smiles",
"aspect_ratio": "landscape",
"quality": "standard"
}
Parametere
image_url * (streng)
URL til kildebildet som skal animeres. Må være offentlig tilgjengelig. Støttede formater: JPG, PNG, WebP.
prompt * (streng)
Beskrivelse av hvordan du animerer bildet. Maks 5000 tegn.
aspect_ratio (streng)
Må samsvare med kildebildets sideforhold for best resultat.
kvalitet (streng)
Forhåndsinnstilt kvalitet. Standard: standard
prompt_directory_optin (boolsk) 💰 -10 KREDITTER
Del videoen din til vår offentlige promptkatalog og få 10 kreditter rabatt! Standard: true
/api/v1/sora/status/{task_id}/
Sjekk generasjonsstatus
Få den nåværende statusen og resultatet av en Sora-videogenereringsoppgave.
Responsstater
Behandling
{
"success": true,
"data": {
"task_id": "sra_2_1234567890abcdef",
"status": "processing",
"progress": 45,
"estimated_completion": "varies by queue"
}
}
Suksess
{
"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"
}
}
Mislyktes
{
"success": false,
"error": "Video generation failed",
"error_details": "Content policy violation detected in prompt",
"credits_refunded": 80
}
Eksempel på cURL
curl -X GET https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/ \
-H "Authorization: Token YOUR_API_KEY"
🔑 Sora 2 API tilgang: offisiell vs UlazAI
Sora 2 API tilgang avhenger av leverandøren, organisasjonsbekreftelsen og kontonivået. Bekreft gjeldende tilgang og priser før integrering.
Offisiell OpenAI API
- Invitasjon / organisasjonsbekreftelse lukket
- Fakturert per sekund av video
- Du administrerer din egen OpenAI-nøkkel og kvoter
Sora 2 på UlazAI
- Ring det nå med én UlazAI API nøkkel - ingen separat invitasjon
- Priset i delte kreditter, refundert ved mislykkede jobber
- Samme nøkkel kaller også Veo 3, Seedance og Kling - sammenlign kostnad og ventetid fra én balanse
Vil du veie Sora 2 mot alternativene først? Se 2026 AI-videomodellveiledning.
💰 Sora 2 Priser
Tekst-til-video
Sjekk gjeldende API-priser
for valgt varighet og modell
• Sjekk gjeldende utgangsinnstillinger
• Sjekk støttede sideforhold
• Behandlingstiden varierer etter kø
Bilde-til-video
Sjekk gjeldende API-priser
for bilde-til-video
• Last opp et støttet bilde du kan bruke
• Tilpassede bevegelsesmeldinger
• Behandlingstiden varierer etter kø
Beregn batchen din fra gjeldende modellkostnad og forventet gjentatt forsøksfrekvens.
📚 Beste praksis
Spørre retningslinjer
- Vær spesifikk om kamerabevegelser (panorering, zoom, tilt)
- Beskriv lys og atmosfære
- Inkluder karakterhandlinger og uttrykk
- Angi timing for viktige øyeblikk
- Unngå opphavsrettsbeskyttede tegn eller merker
Tips til bilde-til-video
- Bruk kildebilder av høy kvalitet (minst 1024 piksler)
- Match sideforhold for å unngå beskjæring
- Beskriv realistisk bevegelse for scenen
- Vurder fysikk og naturlig bevegelse
Webhook-integrasjon
- Videoer lagres automatisk i R2 med CDN-levering
- E-postvarsler sendes når genereringen er fullført
- Poll statusendepunktet hvert 30. sekund for oppdateringer
- Mislykkede generasjoner refunderer automatisk kreditter
⚠️ Feilkoder
400
Ugyldige forespørselsparametere eller for lang forespørsel
401
Ugyldig eller manglende API-nøkkel
402
Utilstrekkelig kreditter
422
Brudd på retningslinjene for innhold
429
Frekvensgrensen er overskredet (maks 10 samtidig)
500
Serverfeil - kreditter vil bli refundert
💻 Kodeeksempler
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();
🚀 Klar til å starte?
Sjekk kontoen din for gjeldende kreditttilbud.