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

# PixVerse

OpenClaw stellt `pixverse` als offizielles externes Plugin für gehostete PixVerse-Videogenerierung bereit. Das Plugin registriert den Provider `pixverse` gegen den Vertrag `videoGenerationProviders`.

| Eigenschaft            | Wert                                                                     |
| ---------------------- | ------------------------------------------------------------------------ |
| Provider-ID            | `pixverse`                                                               |
| Plugin-Paket           | `@openclaw/pixverse-provider`                                            |
| Auth-Umgebungsvariable | `PIXVERSE_API_KEY`                                                       |
| Onboarding-Flag        | `--auth-choice pixverse-api-key`                                         |
| Direkter CLI-Flag      | `--pixverse-api-key <key>`                                               |
| API                    | PixVerse Platform API v2 (`video_id`-Übermittlung plus Ergebnis-Polling) |
| Standardmodell         | `pixverse/v6`                                                            |
| Standard-API-Region    | International                                                            |

## Erste Schritte

<Steps>
  <Step title="Installieren Sie das Plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install clawhub:@openclaw/pixverse-provider
    openclaw gateway restart
    ```
  </Step>

  <Step title="Legen Sie den API-Schlüssel fest">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice pixverse-api-key
    ```

    Der Assistent fragt, ob der internationale Endpunkt
    (`https://app-api.pixverse.ai/openapi/v2`) oder der CN-Endpunkt
    (`https://app-api.pixverseai.cn/openapi/v2`) verwendet werden soll, bevor `region` und
    `baseUrl` in die Provider-Konfiguration geschrieben werden.
  </Step>

  <Step title="Legen Sie PixVerse als Standard-Video-Provider fest">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
    ```
  </Step>

  <Step title="Generieren Sie ein Video">
    Bitten Sie den Agenten, ein Video zu generieren. PixVerse wird automatisch verwendet.
  </Step>
</Steps>

## Unterstützte Modi und Modelle

Der Provider stellt PixVerse-Generierungsmodelle über das gemeinsame Video-Tool von OpenClaw bereit.

| Modus         | Modelle               | Referenzeingabe            |
| ------------- | --------------------- | -------------------------- |
| Text-zu-Video | `v6` (Standard), `c1` | Keine                      |
| Bild-zu-Video | `v6` (Standard), `c1` | 1 lokales oder Remote-Bild |

Lokale Bildreferenzen werden vor der Bild-zu-Video-Anfrage zu PixVerse hochgeladen. Remote-Bild-URLs werden über den PixVerse-Bildupload-Endpunkt als `image_url` weitergegeben.

| Option            | Unterstützte Werte                                                          |
| ----------------- | --------------------------------------------------------------------------- |
| Dauer             | 1-15 Sekunden                                                               |
| Auflösung         | `360P`, `540P`, `720P`, `1080P`                                             |
| Seitenverhältnis  | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` für Text-zu-Video |
| Generiertes Audio | `audio: true`                                                               |

<Note>
  Die PixVerse-Bildvorlagengenerierung wird noch nicht über `image_generate` bereitgestellt. Diese API wird über Template-IDs gesteuert, während der gemeinsame Bildgenerierungsvertrag von OpenClaw derzeit kein PixVerse-spezifisches typisiertes Optionsobjekt hat.
</Note>

## Provider-Optionen

Der Video-Provider akzeptiert diese optionalen Provider-spezifischen Schlüssel:

| Option                               | Typ    | Wirkung                                    |
| ------------------------------------ | ------ | ------------------------------------------ |
| `seed`                               | number | Deterministischer Seed, sofern unterstützt |
| `negativePrompt` / `negative_prompt` | string | Negativer Prompt                           |
| `quality`                            | string | PixVerse-Qualität wie `720p`               |
| `motionMode` / `motion_mode`         | string | Bewegungsmodus für Bild-zu-Video           |
| `cameraMovement` / `camera_movement` | string | PixVerse-Kamerabewegungs-Preset            |
| `templateId` / `template_id`         | number | Aktivierte PixVerse-Template-ID            |

## Konfiguration

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}
```

## Erweiterte Konfiguration

<AccordionGroup>
  <Accordion title="API-Region">
    OpenClaw verwendet standardmäßig die internationale PixVerse-API. Legen Sie `models.providers.pixverse.region`
    manuell fest, wenn Ihr Schlüssel zu einer bestimmten PixVerse-Plattformregion gehört, oder verwenden Sie
    `openclaw onboard --auth-choice pixverse-api-key`, um im Einrichtungsassistenten eine Region auszuwählen:

    | Regionswert     | PixVerse-API-Basis-URL                     |
    | --------------- | ------------------------------------------ |
    | `international` | `https://app-api.pixverse.ai/openapi/v2`   |
    | `cn`            | `https://app-api.pixverseai.cn/openapi/v2` |

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      models: {
        providers: {
          pixverse: {
            region: "cn", // "international" or "cn"
            baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
            models: [],
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Benutzerdefinierte Basis-URL">
    Legen Sie `models.providers.pixverse.baseUrl` nur fest, wenn das Routing über einen vertrauenswürdigen kompatiblen Proxy erfolgt.
    `baseUrl` hat Vorrang vor `region`.

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      models: {
        providers: {
          pixverse: {
            baseUrl: "https://app-api.pixverse.ai/openapi/v2",
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Aufgaben-Polling">
    PixVerse gibt aus der Generierungsanfrage eine `video_id` zurück. OpenClaw pollt
    `/openapi/v2/video/result/{video_id}`, bis die Aufgabe erfolgreich ist, fehlschlägt
    oder ein Timeout erreicht.
  </Accordion>
</AccordionGroup>

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Videogenerierung" href="/de/tools/video-generation" icon="video">
    Gemeinsame Tool-Parameter, Provider-Auswahl und asynchrones Verhalten.
  </Card>

  <Card title="Konfigurationsreferenz" href="/de/gateway/config-agents#agent-defaults" icon="gear">
    Agenten-Standardeinstellungen einschließlich Videogenerierungsmodell.
  </Card>
</CardGroup>