> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pixverse C1 Referenzbild-zu-Video

Das Pixverse C1 Referenzbild-zu-Video-Tool kann auf Basis von 1–7 Referenzbildern kinoreife Videos generieren. Referenzbilder werden im Prompt über die @ref\_name-Syntax referenziert. Unterstützt werden Konsistenz für mehrere Charaktere/Objekte, mehrere Auflösungen (360p–1080p), variable Dauer (1–15 Sekunden) sowie Audiogenerierung.

<Tip>
  Dies ist eine **asynchrone** API, die nur die task\_id der asynchronen Aufgabe zurückgibt. Verwenden Sie diese task\_id, um über die [API zum Abfragen von Aufgabenergebnissen](/de/docs/models/reference-get-async-task-result) das generierte Ergebnis abzurufen.
</Tip>

## Anfrageheader

<ParamField header="Content-Type" type="string" required={true}>
  Enum-Wert: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer-Authentifizierungsformat: Bearer \{\{API Key}}.
</ParamField>

## Anfragetext

<ParamField body="images" type="object[]" required={true}>
  Liste der Referenzbilder (1–7 Bilder)

  Array-Länge: 1 - 7

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="type" type="string" required={true}>
      Typ des Referenzbilds: subject bedeutet, dass die Person/das Objekt im Referenzbild als Hauptmotiv für die Videogenerierung verwendet wird; background bedeutet, dass die Szene/Umgebung im Referenzbild als Hintergrund für die Videogenerierung verwendet wird

      Optionale Werte: `subject`, `background`
    </ParamField>

    <ParamField body="ref_name" type="string" required={true}>
      Kurzer Bezeichnername des Referenzbilds, der im prompt über die @ref\_name-Syntax verwendet wird, um dieses Referenzbild zu referenzieren; auf @ref\_name muss ein Leerzeichen folgen
    </ParamField>

    <ParamField body="image_url" type="string" required={true}>
      URL-Adresse des Referenzbilds
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Szenenbeschreibungstext, der hochgeladene Referenzbilder über die @ref\_name-Syntax referenziert (z. B. „@hero läuft in @city “); auf @ref\_name muss ein Leerzeichen folgen, und der Referenzname muss mit dem ref\_name in images übereinstimmen
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Dauer des generierten Videos (Sekunden), Bereich 1–15

  Wertebereich: \[1, 15]
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Auflösung des Ausgabevideos

  Optionale Werte: `360p`, `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Seitenverhältnis des Ausgabevideos

  Optionale Werte: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`
</ParamField>

<ParamField body="generate_audio_switch" type="boolean" default={false}>
  Ob gleichzeitig natives Videoaudio generiert werden soll
</ParamField>

## Antwortinformationen

<ResponseField name="task_id" type="string" required={true}>
  Verwenden Sie die task\_id, um über die [API zum Abfragen von Aufgabenergebnissen](/de/docs/models/reference-get-async-task-result) die generierte Ausgabe abzurufen.
</ResponseField>