PixVerse V6 API

PixVerse V6 Referenz zu Video besetzt einen Clip mit Bildern, die Sie senden: bis zu 7 Elemente in einer Anfrage. PixVerse nennt diesen Modus Fusion. Jedes Element hat einen Namen, ein Bild und eine Rolle: subject für eine Person, ein Tier, ein Objekt oder ein Produkt, oder background für einen Ort oder eine Umgebung. Schreiben Sie @name im Prompt an die Stelle, an der jedes Element erscheinen soll. Clips laufen 1 bis 15 Sekunden in 360p bis 1080p, in acht Seitenverhältnissen. PixVerse prüft Prompts und Bilder vor der Generierung; abgelehnte Anfragen schlagen fehl und werden nicht berechnet.

Wählen Sie einen PixVerse-V6-Modus nach dem Ausgangsmaterial

Benennen Sie Ihre Elemente

Geben Sie jedem Element einen Namen mit 1 bis 30 Zeichen und rufen Sie es im Prompt mit @name auf. In unserem Test wurden maya (ein Foto einer rothaarigen Frau in einer senffarbenen Jacke) und trailer (ein Foto eines Chrom-Wohnwagens) zu einer Aufnahme in der Dämmerung: Sie geht mit einem dampfenden Emaille-Becher vor dem Wohnwagen auf die Kamera zu, und Lichterketten leuchten. Gesicht, Haare und Jacke stimmten mit der Referenz überein, ebenso der Wohnwagen.

Setzen Sie ein Leerzeichen nach dem Namen

In unserem Test wurde „@trailer,“ mit Komma direkt nach dem Namen abgelehnt, weil der Name nicht passte, während „@trailer and“ funktionierte. Fehlgeschlagene Anfragen werden nicht berechnet. Schreiben Sie @name gefolgt von einem Leerzeichen.

Motive und Hintergründe

Setzen Sie role auf subject (Standard) für Personen, Tiere, Objekte und Produkte oder auf background für einen Ort. Eine Anfrage kann bis zu 7 davon mischen.

Kleine Artefakte kommen vor

In unserem Beispiel zeigte ein Bild kurz eine zweite Figur in der Tür. Prüfen Sie den Clip, bevor Sie ihn verwenden.

Eine Person an einem Ort platzieren, an dem sie nie fotografiert wurde

Ein Porträt als ein Element und ein Foto eines Ortes als Hintergrund, mit der Handlung im Prompt.

Ein Fahrzeug oder Produkt konsistent halten

Geben Sie einem Auto, einem Wohnwagen oder einem Produkt ein eigenes Element, damit es in jedem Clip seinem Foto entspricht.

Eine kurze Szene besetzen

Benennen Sie zwei oder drei Elemente, sagen Sie, wie sie sich begegnen, und fügen Sie eine Kamerabewegung hinzu.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "pixverse/v6/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "duration_seconds": 5
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.