Zum Hauptinhalt springen
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 Bild-zu-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<string>",
  "reference_images": [
    {
      "image": "<string>",
      "reference_type": "<string>"
    }
  ],
  "aspect_ratio": "<string>",
  "duration_seconds": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>",
  "resolution": "<string>",
  "sample_count": 123,
  "seed": {}
}
'
{
  "task_id": "<string>"
}
Die API der Veo 3.1 Preview-Version ist automatisch mit dieser Schnittstelle kompatibel.
Verwenden Sie das Videogenerierungsmodell Veo 3.1, um durch Eingabe eines Bildes und einer Textbeschreibung hochwertige Videoinhalte zu erstellen. Diese Schnittstelle verarbeitet Anfragen asynchron; das endgültige Generierungsergebnis muss über die task_id abgefragt werden.

​
Anforderungsheader

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

​
Anforderungstext

​
prompt
string
erforderlich
Eine Textzeichenfolge, die das Video beschreibt, das Sie generieren möchten.
​
image
string
Eingabebild; unterstützt URL oder base64-kodierte Eingabe.
​
last_image
string
Abschlussbild, das zum Füllen des letzten Frames des Videos verwendet wird. Unterstützt URL oder base64-kodierte Eingabe.
​
reference_images
object[]
Eine Liste mit bis zu drei asset-Bildern oder bis zu einem style-Bild, die Referenzbilder beschreiben, die das Modell beim Generieren des Videos verwendet.
​
aspect_ratio
string
Gibt das Seitenverhältnis des generierten Videos an.Enumerationswerte: 16:9, 9:16. Der Standardwert ist 16:9.
​
duration_seconds
integer
Die Länge der Videodatei, die Sie generieren möchten, in Sekunden.Enumerationswerte: 4, 6, 8; bei Verwendung von reference_images ist nur 8 möglich.Der Standardwert ist 8.
​
enhance_prompt
boolean
Gibt an, ob Gemini verwendet werden soll, um Ihren Prompt zu verbessern. Es wird nur true unterstützt.Standardwert: true
​
generate_audio
boolean
erforderlich
Gibt an, ob Audio für das Video generiert werden soll.
​
negative_prompt
string
Eine Textzeichenfolge, die beschreibt, welche Inhalte das Modell nicht generieren soll.
​
person_generation
string
Sicherheitseinstellung, die steuert, ob die Generierung von Personen oder Gesichtern erlaubt ist.Enumerationswerte:
  • allow_adult (Standard): Erlaubt nur die Generierung von Erwachsenen
  • dont_allow: Erlaubt keine Personen oder Gesichter im Bild
  • allow_all: Erlaubt die Generierung von Personen aller Altersgruppen (das Projekt muss in der allowlist enthalten sein)
​
resolution
string
Die Auflösung des generierten Videos.Enumerationswerte: 720p (Standard) oder 1080p
​
sample_count
integer
Die Anzahl der zu generierenden Videobeispiele.Wertebereich: 1-4
​
seed
uint32
Eine Zahl zur Initialisierung des Zufallsgenerierungsprozesses. Die Verwendung desselben Seeds, Prompts und derselben anderen Parameter erzeugt dasselbe Ausgabevideo, wodurch der Generierungsprozess deterministisch wird.Wertebereich: 0-4,294,967,295

​
Antwortparameter

​
task_id
string
erforderlich
Die task_id der asynchronen Aufgabe. Verwenden Sie diese task_id, um die API zum Abfragen des Aufgabenergebnisses aufzurufen und das Generierungsergebnis abzurufen.