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

# معاينة تحديد فيديو Kling

> استخدم نقطة نهاية Preview Selected Video Area لعرض معاينة سريعة للمناطق المختارة في تعديلات الفيديو متعددة الوسائط في Kling عبر CometAPI.

استخدم نقطة النهاية هذه لمعاينة المنطقة المحددة قبل إرسال مهمة التعديل متعددة الوسائط النهائية.

## لماذا تُعد المعاينة مهمة

* تتيح لك التحقق من أن نقاط التحديد تغطي العنصر أو المنطقة المقصودة
* تساعد في اكتشاف الأقنعة غير الجيدة قبل أن تستهلك استدعاء توليد
* إنها أكثر نقطة تحقق أمانًا بين تعديل التحديد وإنشاء المهمة النهائية

## الدور في سير العمل

<Steps>
  <Step title="تهيئة الجلسة">
    ابدأ باستخدام [Initialize Video for Editing](./initialize-video-for-editing) واحتفظ بالقيمة `session_id` المُعادة ضمن الحساب نفسه.
  </Step>

  <Step title="إضافة نقاط التحديد">
    استخدم [Add Video Selection](./add-video-selection) حتى تصبح المنطقة قريبة من الشكل الصحيح.
  </Step>

  <Step title="المعاينة قبل التوليد">
    استدعِ نقطة النهاية هذه، ثم تابع إلى [Create Task](./create-task) فقط بعد أن يبدو التحديد صحيحًا.
  </Step>
</Steps>

<Tip>
  للاطلاع على المرجع الكامل للمعلمات، راجع [توثيق Kling API](https://kling.ai/document-api/apiReference/model/multiElements).
</Tip>


## OpenAPI

````yaml api/openapi/video/kling/multimodal-video-editing/post-preview-selected-video-area.openapi.json POST /kling/v1/videos/multi-elements/preview-selection
openapi: 3.1.0
info:
  title: Preview Selected Video Area API
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/videos/multi-elements/preview-selection:
    post:
      summary: Preview Selected Video Area
      operationId: preview_selected_video_area
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - session_id
              properties:
                session_id:
                  type: string
                  description: Session id returned by the video initialization endpoint.
              default:
                session_id: <session_id>
            examples:
              Default:
                summary: Default
                value:
                  session_id: <session_id>
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                properties:
                  code:
                    type: integer
                    description: Response code. `0` means the request succeeded.
                  message:
                    type: string
                    description: Response message.
                  data:
                    type: object
                    description: Route-specific response payload when present.
                    additionalProperties: true
                additionalProperties: true
      x-codeSamples:
        - lang: Shell
          label: Default
          source: >
            curl
            https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection
            \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "session_id": "<session_id>"
                }'
        - lang: Python
          label: Default
          source: |
            import os
            import requests

            response = requests.post(
                "https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                  "session_id": "<session_id>"
                },
            )

            result = response.json()
            print(result.get("code"), result.get("data"))
        - lang: JavaScript
          label: Default
          source: >
            const response = await
            fetch("https://api.cometapi.com/kling/v1/videos/multi-elements/preview-selection",
            {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "session_id": "<session_id>"
              }),
            });


            const result = await response.json();

            console.log(result.code, result.data);
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````