Zum Hauptinhalt springen
POST
/
v3
/
async
/
veo-3.1-generate-reference
Veo 3.1 Videogenerierung mit Referenzbildern
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-reference \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "sample_count": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "reference_images": [
    {}
  ],
  "person_generation": "<string>"
}
'
{
  "task_id": "<string>"
}
Generieren Sie Videos mit dem Google Veo 3.1-Modell, gesteuert durch 1–3 Referenzbilder. Unterstützt Auflösungen von 720p und 1080p sowie Seitenverhältnisse von 16:9 und 9:16. Die Dauer ist fest auf 8 Sekunden eingestellt. Als Referenztyp wird nur asset unterstützt.
Dies ist eine asynchrone API, die nur die task_id der asynchronen Aufgabe zurückgibt. Sie sollten diese task_id verwenden, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das generierte Ergebnis abzurufen.

​
Anfrageheader

​
Content-Type
string
erforderlich
Enumerationswert: application/json
​
Authorization
string
erforderlich
Bearer-Authentifizierungsformat: Bearer {{API Key}}.

​
Anfragetext

​
seed
integer
Zufalls-Seed zur Reproduktion der Generierungsergebnisse.Wertebereich: [0, 4294967295]
​
prompt
string
erforderlich
Text-Prompt, der den gewünschten Videoinhalt beschreibt.
​
resolution
string
Standard:"720p"
Ausgabevideoauflösung.Optionale Werte: 720p, 1080p
​
aspect_ratio
string
Standard:"16:9"
Seitenverhältnis des Ausgabevideos.Optionale Werte: 16:9, 9:16
​
sample_count
integer
Standard:1
Anzahl der zu generierenden Videobeispiele (1–4).Wertebereich: [1, 4]
​
enhance_prompt
boolean
Standard:true
Gibt an, ob die KI den Prompt umschreiben soll, um bessere Generierungsergebnisse zu erzielen.
​
generate_audio
boolean
Standard:false
Gibt an, ob gleichzeitig Audio generiert werden soll.
​
negative_prompt
string
Beschreibt Inhalte, die im generierten Video vermieden werden sollen.
​
reference_images
array
erforderlich
1–3 Referenzbilder zur Steuerung der Videogenerierung. Jedes Element enthält eine Bild-URL oder Base64-codierte Daten sowie den Referenztyp.Array-Länge: 1 - 3
​
person_generation
string
Standard:"allow_adult"
Gibt an, ob die Generierung erwachsener Personen erlaubt ist. allow_adult: Generierung Erwachsener erlauben; dont_allow: Generierung von Personen nicht erlauben.Optionale Werte: allow_adult, dont_allow

​
Antwortinformationen

​
task_id
string
Verwenden Sie die task_id, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und die generierte Ausgabe abzurufen.