Was macht Sora-Video-Generierung?
Generiere KI-Videos über die AceDataCloud OpenAI Sora API.
Einrichtung: Siehe Authentifizierung für das Token-Setup.
Schnellstart
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "ein Golden Retriever, der bei Sonnenuntergang am Strand rennt", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
Asynchron: Siehe Task-Polling. Rufe
POST /sora/tasksmit{"id": "..."}auf.
Modelle
| Modell | Dauer | Qualität | Am besten geeignet für |
|---|---|---|---|
sora-2 | 10–15s | Standard | Die meisten Aufgaben (Standard) |
sora-2-pro | 10–25s | Höher | Premium-Qualität, längere Videos |
Workflows
1. Text-zu-Video
POST /sora/videos
{
"prompt": "eine belebte Tokioter Straße bei Nacht mit Neonschildern, die sich in Regenpfützen spiegeln",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. Bild-zu-Video
Verwende Referenzbilder, um die Generierung zu steuern.
POST /sora/videos
{
"prompt": "die Szene erwacht allmählich mit sanfter Bewegung zum Leben",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. Zeichengesteuertes Video
Extrahiere einen Charakter aus einem bestehenden Video und verwende ihn in einer neuen Szene.
POST /sora/videos
{
"prompt": "der Charakter geht durch eine futuristische Stadt",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
Parameter
| Parameter | Werte | Beschreibung |
|---|---|---|
model | "sora-2", "sora-2-pro" | Zu verwendendes Modell (erforderlich) |
size | "small", "large" | Videoauflösung |
duration | 10, 15, 25 | Dauer in Sekunden (25 nur mit sora-2-pro) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | Videoausrichtung |
version | "1.0" | API-Version — Version 1.0 ermöglicht Dauer bis zu 25s, Ausrichtung, Zeichenreferenzen und Bildeingaben |
Fallstricke
- Eine Dauer von 25 Sekunden ist nur mit dem Modell
sora-2-proverfügbar size: "large"erzeugt eine höhere Auflösung, kostet aber mehr und dauert länger- Die zeichengesteuerte Generierung erfordert
character_startundcharacter_endZeitstempel (in Sekunden) aus dem Quellvideo orientationlegt das Seitenverhältnis fest – verwende"portrait"für mobile Inhalte- Task-Status verwenden
"succeeded"(nicht "completed") – prüfe beim Polling auf diesen Wert
MCP:
pip install mcp-sora| Gehostet:https://sora.mcp.acedata.cloud/mcp| Siehe alle MCP-Server