Hoppa till huvudinnehåll

​
Introduktion

Sora är en AI-videotjänst från Ace Data Cloud, med OpenAI Sora videogenereringsmodell. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Sora med Python för att skapa video från text, med olika längder, liggande eller stående format, karaktärskontroll, referensbilder med mera.

​
Förutsättningar

  • Ett konto hos Ace Data Cloud och en API-token
  • Python 3.7 eller senare
  • Installera requests-biblioteket: pip install requests

​
Grundläggande användning

Huvudendpoint för att anropa Sora API är: 
POST https://api.acedata.cloud/sora/videos
Det här exemplet använder modellen sora-2. Tillgängliga modeller inkluderar: sora-2, sora-2-pro. Fullständigt Python-exempel: 
import requests

url = "https://api.acedata.cloud/sora/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "prompt": "A cat running across a sunny meadow",
    "model": "sora-2",
    "duration": 10,
    "orientation": "landscape"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Byt ut YOUR_API_TOKEN mot din faktiska token från Ace Data Cloud-plattformen.

​
Hantering av svar

Vid lyckad anrop returnerar API:et data i JSON-format. Kontrollera HTTP-statuskoden: 
if response.status_code == 200:
    result = response.json()
    print("Anrop lyckades:", result)
else:
    print(f"Anrop misslyckades, statuskod: {response.status_code}")
    print(response.text)

​
Avancerad användning

För API:er som stödjer asynkrona uppgifter kan resultat erhållas via callback-URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Resultatet skickas sedan till din server via callback-URL

​
Felsökning

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräcklig balans eller ingen åtkomst
429För många förfrågningar
500Intern serverfel

​
Andra endpoints

Sora-tjänsten erbjuder även följande endpoint:
  • POST https://api.acedata.cloud/sora/tasks

​
Nästa steg