Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
Autorisierung

​
Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel abrufen:Besuchen Sie die Seite zur API-Schlüsselverwaltung, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:
Authorization: Bearer YOUR_API_KEY

​
Anfrageparameter

​
model
string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • viduq3-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
​
prompt
string
erforderlich
Textprompt, maximal 2000 ZeichenErforderlich für Text-to-Video. Optional für Image-to-Video und den Modus „Erstes + letztes Bild”.Beispiel: "A cat playing piano, camera slowly zooms in"
​
duration
integer
Standard:"5"
Videodauer (Sekunden)Bereich: 1 bis 16Standard: 5
​
resolution
string
Standard:"720p"
Auflösung des VideosOptionen:
  • 540p — Standardauflösung
  • 720p — HD (Standard)
  • 1080p — Full HD
Standard: 720p
​
aspect_ratio
string
Seitenverhältnis des Videos (nur für den Text-to-Video-Modus)Optionen:
  • 16:9 — Querformat
  • 9:16 — Hochformat
  • 4:3 — Traditionell
  • 3:4 — Traditionelles Hochformat
  • 1:1 — Quadrat
Dieser Parameter ist nur im Text-to-Video-Modus verfügbar (wenn image_urls nicht angegeben ist).
​
image_urls
array<url>
Array mit Bild-URLs für die Image-to-Video-GenerierungDas System bestimmt den Generierungsmodus automatisch anhand der Anzahl der Bilder:
  • 0 Bilder (nicht angegeben): Text-to-Video-Modus
  • 1 Bild: Image-to-Video-Modus (das Bild wird als Startbild verwendet)
  • 2 Bilder: Modus „Erstes + letztes Bild” (erstes Bild = erstes Bild, zweites Bild = letztes Bild)
Beispiel: ["https://example.com/photo.jpg"]
  • Maximal 2 Bilder unterstützt
  • Für den Modus „Erstes + letztes Bild” müssen genau 2 Bilder bereitgestellt werden
  • Wenn image_urls angegeben ist (egal ob 1 oder 2 Bilder), kann der Parameter aspect_ratio nicht verwendet werden — das Seitenverhältnis wird automatisch durch das Bild bestimmt
​
audio
boolean
Standard:"true"
Ob Audio (Dialoge, Soundeffekte) erzeugt werden sollStandard: trueSetzen Sie auf false, wenn Sie ein stummes Video benötigen.
​
seed
integer
Seed-Ganzzahl zur Steuerung der Zufälligkeit bei der GenerierungWertebereich: Ganzzahl zwischen -1 und 2^32-1
  • Bei gleicher Anfrage führen unterschiedliche Seed-Werte (einschließlich nicht angegeben oder -1, was eine Zufallszahl verwendet) zu unterschiedlichen Ergebnissen
  • Bei gleicher Anfrage erzeugt derselbe Seed-Wert ähnliche Ergebnisse, eine exakte Reproduzierbarkeit ist jedoch nicht garantiert

​
Automatisches Routing

Das System bestimmt den Generierungsmodus automatisch anhand der Anzahl der Bilder in image_urls:
Anzahl BilderModusBeschreibung
0 (nicht angegeben)Text-to-VideoGenerierung nur aus der Textbeschreibung
1Image-to-VideoDas Bild wird als Startbild verwendet
2Erstes + letztes BildErstes Bild = erstes Bild, zweites Bild = letztes Bild

​
Parameter-Support-Matrix

ParameterText-to-VideoImage-to-VideoErstes + letztes Bild
model✅ Erforderlich✅ Erforderlich✅ Erforderlich
prompt✅ ErforderlichOptionalOptional
image_urls-✅ 1 Bild✅ 2 Bilder
duration✅ 1–16 s✅ 1–16 s✅ 1–16 s
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
Antwort

​
code
integer
Statuscode der Antwort, 200 bei Erfolg
​
data
array
Datenarray der Antwort

​
Anwendungsfälle

​
Fall 1: Text-zu-Video

{
  "model": "viduq3-pro",
  "prompt": "A cat playing piano, camera slowly zooms in",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Fall 2: Bild-zu-Video (einzelnes Bild)

{
  "model": "viduq3-pro",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Fall 3: Video aus erstem und letztem Bild

{
  "model": "viduq3-pro",
  "prompt": "The person gradually sits down from standing",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Fall 4: Stummes Video (Audio deaktiviert)

{
  "model": "viduq3-pro",
  "prompt": "Sunset seascape timelapse photography",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die bei der Einreichung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis abzufragen.