Videos generieren
Die Übermittlung gibt HTTP 202 mit einer ShareAI-Job-ID und einer Abfrage-URL zurück.
Auf dieser Seite
https://api.shareai.now/api/v1/videosVideos generieren
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
Die Einreichung gibt HTTP 202 mit einer ShareAI-Job-ID und einer Abfrage-URL zurück. Senden Sie einen stabilen Idempotency-Key Header für Wiederholungen derselben Anfrage. Die Wiederverwendung dieses Schlüssels mit unterschiedlichen Eingaben wird abgelehnt. Abfragen GET /api/v1/videos/{id} mit denselben ursprünglichen Anmeldedaten. Zustände umfassen queued, pending, in_progress, finalizing, completed, failed und requires_review. Ein requires_review-Ergebnis erfordert eine Abstimmung im Team; Abfragen starten niemals eine weitere Generierung.
Bevor Sie beginnen#
Setzen Sie SHAREAI_API_KEY auf Ihrem Server und ersetzen Sie den Modell-Platzhalter durch ein derzeit aktiviertes Modell. Geben Sie den API-Schlüssel niemals im Browsercode preis. Das Modell, das Konto, die Berechtigung und der Anbieter müssen diese Operation erlauben. Die unten aufgeführten optionalen Einstellungen erfordern Modellunterstützung; die Sicherheitsgrenzen der API garantieren nicht, dass jedes Modell jeden Wert unterstützt.
Eine Anfrage senden#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Anforderungsfelder#
| Feld | Typ | Bedeutung und Grenzen |
|---|---|---|
model erforderlich | Zeichenkette | Exakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein. |
prompt erforderlich | Zeichenkette | Nichtleere Generierungsaufforderung, maximal 256 KiB UTF-8-Text. |
duration | Ganzzahl | Optionale angeforderte Videodauer in Sekunden, 1–600, weiter eingeschränkt durch das ausgewählte Modell. Tatsächlich zurückgegebene Dauern bestimmen die Abrechnungsdauer. |
resolution | Zeichenkette | Modellunterstützter Auflösungswähler, maximal 100 Zeichen; muss mit der veröffentlichten Tarifvariante übereinstimmen. |
aspect_ratio | Zeichenkette | Modellunterstützter Seitenverhältnis-Wähler, maximal 100 Zeichen. |
size | Zeichenkette | Modellunterstützte Ausgabengröße, maximal 100 Zeichen, zum Beispiel 1024×1024. Nicht jedes Modell unterstützt diese Option. |
generate_audio | Boolean | Optionaler Video-Soundtrack-Wähler. Modellunterstützung und die passende Tarifvariante sind erforderlich. |
seed | Ganzzahl | Optional modellunterstützte Seed. Video erfordert eine nichtnegative Ganzzahl; die Reproduzierbarkeit hängt vom Ausführenden ab. |
frame_images | Array | Maximal zwei image_url-Teile, jeweils mit frame_type first_frame oder last_frame, ohne Duplikate. Kombinieren Sie keine frame_images und input_references. |
input_references | Array | Maximal 16 typisierte image_url-Teile mit image_url.url, die auf eine HTTPS-URL oder unterstützte Bilddaten-URL gesetzt sind. Modellunterstützung ist erforderlich. |
provider | Objekt | Optionale Routing-Präferenzen für Anbieter. Verwenden Sie provider.only für akzeptierte Anbieter-Tags, nicht als Präfix in der Modell-ID. Konto- und Berechtigungsbeschränkungen gelten weiterhin. |
allow_temporary_retention | Boolean | Nur Video. Explizites true erlaubt die temporäre Zwischenspeicherung des Ergebnisses auf Routen, die dies erfordern. Weglassen/false macht diese Routen unzugänglich. Konflikte mit provider.zdr:true; andere Operationen behalten obligatorisches ZDR bei. |
Das Ergebnis lesen#
Erfolg gibt HTTP 202 mit JSON zurück. Die Einreichung gibt HTTP 202 mit einer ShareAI-Job-ID und einer Abfrage-URL zurück. Senden Sie einen stabilen Idempotency-Key Header für Wiederholungen derselben Anfrage. Die Wiederverwendung dieses Schlüssels mit unterschiedlichen Eingaben wird abgelehnt. Abfragen GET /api/v1/videos/{id} mit denselben ursprünglichen Anmeldedaten. Zustände umfassen queued, pending, in_progress, finalizing, completed, failed und requires_review. Ein requires_review-Ergebnis erfordert eine Abstimmung im Team; Abfragen starten niemals eine weitere Generierung.
Abrechnungseinheiten#
Videorouten deklarieren ihre abgerechneten Einheiten. Eine pro-Sekunde-Route wird basierend auf der gemessenen Dauer jeder zurückgegebenen Datei abgerechnet, niemals basierend auf der angeforderten Dauer oder einem upstream USD-Kostenpunkt. Die angeforderte Dauer muss zwischen 1 und 600 Sekunden liegen und vom Modell unterstützt werden. Eine konservative Kreditreserve kann bis zu vier Ausgaben abdecken.
Wählen Sie die exakte aktivierte Modellkennung aus der Konsole. Die deklarierte Operation und die Eingabe-/Ausgabefunktionen müssen mit diesem Endpunkt übereinstimmen; ein Text-Chat-Modell kann nicht für eine andere Operation ersetzt werden. Ihre Berechtigungen, Anbieter- und Kontobeschränkungen gelten weiterhin.
Preise und Nutzung#
Die Tarife werden in EUR AI-Credits für das ausgewählte Modell, den Anbieter, die Einheiten und Varianten veröffentlicht. Es werden nur die Dimensionen im aktiven Tarif berechnet. Eine Schätzung reserviert Credits vor der Ausführung; die endgültigen Kosten basieren auf gemessener Nutzung. Preise können von der Auflösung, dem Ausgabeformat oder einem Nutzungsband abhängen. Überprüfen Sie die Konsolennutzung für die endgültige ShareAI-Belastung. Upstream-Kostenfelder und Medienbytes werden nicht in erfundene Token-Mengen umgerechnet.
Zugriff und Fehler#
Verwenden Sie inference für genehmigte netzwerkkostenbasierte Inferenz oder monetization_gateway für einen genehmigten Builder-Aufschlag und akzeptierte Abrechnungsbedingungen. Zugriff nur mit Identitätsnachweis autorisiert keine Ausgaben. Validierung, Modellautorisierung, unzureichende Credits, Ratenlimits und Ausführungsfehler geben eine strukturierte error. Nach einem Timeout oder einer unsicheren Übermittlung überprüfen Sie die Nutzung oder den Videoauftrag, bevor Sie eine weitere potenziell kostenpflichtige Anfrage erstellen.
Temporäre Videoaufbewahrung#
Einige Videorouten benötigen eine temporäre Zwischenspeicherung upstream, damit das generierte Ergebnis abgerufen werden kann. Sie erfordern Ihre ausdrückliche allow_temporary_retention:true Zustimmung zu dieser Videoanfrage. Das Weglassen macht diese Routen unzugänglich. Diese Ausnahme gilt nur für Video und erlaubt niemals Modelltraining oder die Zwischenspeicherung für andere Operationen. Eine explizite ZDR-Richtlinie kann nicht stillschweigend abgeschwächt werden.
JSON
{"allow_temporary_retention": true}Jobstatus prüfen#
https://api.shareai.now/api/v1/videos/{id}Lesen Sie eine Videogenerierung mit den ursprünglichen Anmeldedaten
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}Das obige JSON veranschaulicht die stabilen Jobfelder, keine echte Generierung. Abfragen Sie den ShareAI-Pfad mit demselben Schlüssel und warten Sie zwischen den Überprüfungen. queued, pending, in_progress und finalizing bedeuten warten; completed gibt Daten mit ShareAI-Content-URLs frei; failed und requires_review bedeuten stoppen und überprüfen. Status nach vorübergehenden Fehlern erneut abfragen, aber keine Generierung automatisch erneut einreichen. Ein anderer oder widerrufener Anmeldedatensatz kann den Job nicht abrufen.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Ergebnis herunterladen#
Nach Abschluss enthält jeder Dateneintrag eine ShareAI-Content-URL. Abrufen GET /api/v1/videos/{id}/content?index=0 mit denselben ursprünglichen Anmeldedaten. Der Endpunkt unterstützt einen einzelnen HTTP-Byte-Bereich. Provider-URLs, private Tickets und Provider-Anmeldedaten werden niemals zurückgegeben. Abfragen und Herunterladen erzeugen keine zweite Inferenzanfrage oder Monetization Gateway-Ingestionsgebühr. Ein abgeschlossener Job bedeutet, dass die Abrechnung bestätigt ist, bevor die Datei heruntergeladen werden kann.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4Optionale frame_images müssen Bild-URLs mit first_frame oder last_frame enthalten. Verwenden Sie Frame-Bilder oder Referenzbilder in einer Anfrage, nicht beides. Modelldauern, Auflösungen und Seitenverhältnisse können restriktiver sein als die Sicherheitsgrenzen der API. Webhooks und beliebige Callback-URLs werden nicht unterstützt.
Zuletzt aktualisiert am 3. November 2026