> ## 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 `pixverse` بصفته Plugin خارجيًا رسميًا لتوليد فيديو PixVerse المستضاف. يسجّل Plugin مزوّد `pixverse` مقابل عقد `videoGenerationProviders`.

| الخاصية              | القيمة                                                         |
| -------------------- | -------------------------------------------------------------- |
| معرّف المزوّد        | `pixverse`                                                     |
| حزمة Plugin          | `@openclaw/pixverse-provider`                                  |
| متغير بيئة المصادقة  | `PIXVERSE_API_KEY`                                             |
| علم التهيئة          | `--auth-choice pixverse-api-key`                               |
| علم CLI المباشر      | `--pixverse-api-key <key>`                                     |
| API                  | PixVerse Platform API v2 (إرسال `video_id` مع استطلاع النتائج) |
| النموذج الافتراضي    | `pixverse/v6`                                                  |
| منطقة API الافتراضية | دولية                                                          |

## البدء

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

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

    يسأل المعالج هل تريد استخدام نقطة النهاية الدولية
    (`https://app-api.pixverse.ai/openapi/v2`) أم نقطة نهاية CN
    (`https://app-api.pixverseai.cn/openapi/v2`) قبل كتابة `region` و
    `baseUrl` في إعدادات المزوّد.
  </Step>

  <Step title="Set PixVerse as the default video provider">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
    ```
  </Step>

  <Step title="Generate a video">
    اطلب من الوكيل توليد فيديو. سيُستخدم PixVerse تلقائيًا.
  </Step>
</Steps>

## الأوضاع والنماذج المدعومة

يعرض المزوّد نماذج توليد PixVerse عبر أداة الفيديو المشتركة في OpenClaw.

| الوضع                  | النماذج              | إدخال مرجعي               |
| ---------------------- | -------------------- | ------------------------- |
| تحويل النص إلى فيديو   | `v6` (افتراضي)، `c1` | لا شيء                    |
| تحويل الصورة إلى فيديو | `v6` (افتراضي)، `c1` | صورة محلية أو بعيدة واحدة |

تُرفع مراجع الصور المحلية إلى PixVerse قبل طلب تحويل الصورة إلى فيديو. تُمرّر عناوين URL للصور البعيدة عبر نقطة نهاية رفع الصور في PixVerse باسم `image_url`.

| الخيار                  | القيم المدعومة                                                                  |
| ----------------------- | ------------------------------------------------------------------------------- |
| المدة                   | 1-15 ثانية                                                                      |
| الدقة                   | `360P`, `540P`, `720P`, `1080P`                                                 |
| نسبة العرض إلى الارتفاع | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` لتحويل النص إلى فيديو |
| الصوت المولّد           | `audio: true`                                                                   |

<Note>
  توليد قوالب الصور في PixVerse غير معروض عبر `image_generate` حتى الآن. يعتمد ذلك API على معرّف القالب، بينما لا يتضمن عقد توليد الصور المشترك في OpenClaw حاليًا حزمة خيارات typed خاصة بـ PixVerse.
</Note>

## خيارات المزوّد

يقبل مزوّد الفيديو هذه المفاتيح الاختيارية الخاصة بالمزوّد:

| الخيار                               | النوع  | التأثير                          |
| ------------------------------------ | ------ | -------------------------------- |
| `seed`                               | number | بذرة حتمية عند دعمها             |
| `negativePrompt` / `negative_prompt` | string | موجّه سلبي                       |
| `quality`                            | string | جودة PixVerse مثل `720p`         |
| `motionMode` / `motion_mode`         | string | وضع حركة تحويل الصورة إلى فيديو  |
| `cameraMovement` / `camera_movement` | string | إعداد مسبق لحركة كاميرا PixVerse |
| `templateId` / `template_id`         | number | معرّف قالب PixVerse مفعّل        |

## الإعدادات

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

## الإعدادات المتقدمة

<AccordionGroup>
  <Accordion title="API region">
    يستخدم OpenClaw افتراضيًا PixVerse API الدولي. عيّن `models.providers.pixverse.region`
    يدويًا عندما ينتمي مفتاحك إلى منطقة منصة PixVerse محددة، أو استخدم
    `openclaw onboard --auth-choice pixverse-api-key` لاختيار منطقة في معالج الإعداد:

    | قيمة المنطقة    | عنوان URL الأساسي لـ PixVerse API          |
    | --------------- | ------------------------------------------ |
    | `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="Custom base URL">
    عيّن `models.providers.pixverse.baseUrl` فقط عند التوجيه عبر وكيل موثوق ومتوافق.
    تكون لـ `baseUrl` أسبقية على `region`.

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

  <Accordion title="Task polling">
    يعيد PixVerse قيمة `video_id` من طلب التوليد. يستطلع OpenClaw
    `/openapi/v2/video/result/{video_id}` حتى تنجح المهمة أو تفشل
    أو تنتهي مهلتها.
  </Accordion>
</AccordionGroup>

## ذات صلة

<CardGroup cols={2}>
  <Card title="Video generation" href="/ar/tools/video-generation" icon="video">
    معلمات الأداة المشتركة، واختيار المزوّد، والسلوك غير المتزامن.
  </Card>

  <Card title="Configuration reference" href="/ar/gateway/config-agents#agent-defaults" icon="gear">
    إعدادات الوكيل الافتراضية، بما في ذلك نموذج توليد الفيديو.
  </Card>
</CardGroup>