> ## 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 proporciona `pixverse` como Plugin externo oficial para la generación de video alojada de PixVerse. El Plugin registra el proveedor `pixverse` contra el contrato `videoGenerationProviders`.

| Propiedad                    | Valor                                                                   |
| ---------------------------- | ----------------------------------------------------------------------- |
| Id. de proveedor             | `pixverse`                                                              |
| Paquete del Plugin           | `@openclaw/pixverse-provider`                                           |
| Variable de entorno de auth  | `PIXVERSE_API_KEY`                                                      |
| Marca de onboarding          | `--auth-choice pixverse-api-key`                                        |
| Marca directa de CLI         | `--pixverse-api-key <key>`                                              |
| API                          | PixVerse Platform API v2 (envío de `video_id` más sondeo de resultados) |
| Modelo predeterminado        | `pixverse/v6`                                                           |
| Región de API predeterminada | Internacional                                                           |

## Primeros pasos

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

  <Step title="Configurar la clave de API">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice pixverse-api-key
    ```

    El asistente pregunta si se debe usar el endpoint internacional
    (`https://app-api.pixverse.ai/openapi/v2`) o el endpoint de CN
    (`https://app-api.pixverseai.cn/openapi/v2`) antes de escribir `region` y
    `baseUrl` en la configuración del proveedor.
  </Step>

  <Step title="Configurar PixVerse como proveedor de video predeterminado">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
    ```
  </Step>

  <Step title="Generar un video">
    Pide al agente que genere un video. PixVerse se usará automáticamente.
  </Step>
</Steps>

## Modos y modelos compatibles

El proveedor expone modelos de generación de PixVerse mediante la herramienta de video compartida de OpenClaw.

| Modo           | Modelos                     | Entrada de referencia   |
| -------------- | --------------------------- | ----------------------- |
| Texto a video  | `v6` (predeterminado), `c1` | Ninguna                 |
| Imagen a video | `v6` (predeterminado), `c1` | 1 imagen local o remota |

Las referencias de imágenes locales se cargan en PixVerse antes de la solicitud de imagen a video. Las URL de imágenes remotas se pasan a través del endpoint de carga de imágenes de PixVerse como `image_url`.

| Opción              | Valores compatibles                                                          |
| ------------------- | ---------------------------------------------------------------------------- |
| Duración            | 1-15 segundos                                                                |
| Resolución          | `360P`, `540P`, `720P`, `1080P`                                              |
| Relación de aspecto | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` para texto a video |
| Audio generado      | `audio: true`                                                                |

<Note>
  La generación de plantillas de imagen de PixVerse aún no se expone mediante `image_generate`. Esa API está controlada por id. de plantilla, mientras que el contrato compartido de generación de imágenes de OpenClaw actualmente no tiene un conjunto de opciones tipadas específico de PixVerse.
</Note>

## Opciones del proveedor

El proveedor de video acepta estas claves opcionales específicas del proveedor:

| Opción                               | Tipo   | Efecto                                        |
| ------------------------------------ | ------ | --------------------------------------------- |
| `seed`                               | number | Semilla determinista cuando sea compatible    |
| `negativePrompt` / `negative_prompt` | string | Prompt negativo                               |
| `quality`                            | string | Calidad de PixVerse como `720p`               |
| `motionMode` / `motion_mode`         | string | Modo de movimiento de imagen a video          |
| `cameraMovement` / `camera_movement` | string | Preajuste de movimiento de cámara de PixVerse |
| `templateId` / `template_id`         | number | Id. de plantilla activada de PixVerse         |

## Configuración

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

## Configuración avanzada

<AccordionGroup>
  <Accordion title="Región de API">
    OpenClaw usa de forma predeterminada la API internacional de PixVerse. Configura `models.providers.pixverse.region`
    manualmente cuando tu clave pertenezca a una región específica de la plataforma PixVerse, o usa
    `openclaw onboard --auth-choice pixverse-api-key` para elegir una en el asistente de configuración:

    | Valor de región | URL base de la API de PixVerse             |
    | --------------- | ------------------------------------------ |
    | `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="URL base personalizada">
    Configura `models.providers.pixverse.baseUrl` solo al enrutar a través de un proxy compatible de confianza.
    `baseUrl` tiene prioridad sobre `region`.

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

  <Accordion title="Sondeo de tareas">
    PixVerse devuelve un `video_id` desde la solicitud de generación. OpenClaw sondea
    `/openapi/v2/video/result/{video_id}` hasta que la tarea se realiza correctamente, falla
    o agota el tiempo de espera.
  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Generación de video" href="/es/tools/video-generation" icon="video">
    Parámetros de herramienta compartida, selección de proveedor y comportamiento asíncrono.
  </Card>

  <Card title="Referencia de configuración" href="/es/gateway/config-agents#agent-defaults" icon="gear">
    Configuración predeterminada del agente, incluido el modelo de generación de video.
  </Card>
</CardGroup>