إعدادات المشروع

يمتلك كل مشروع إعدادات نشطة — trim وbackground وsubtitle style وlayout — تتحكم في كيفية عرض عمليات التصدير. استخدم إعدادات المشروع عندما تريد تجاوزات محلية خاصة بالمشروع لا تستحق مشاركتها كـ preset. راجع Render settings reference للحصول على خريطة الحقول المشتركة preset وsettings.style وsettingsOverride.

Endpoints

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	جلب إعدادات المشروع النشطة.
`PATCH`	`/projects/{projectId}/settings`	تطبيق preset أو تعديل الإعدادات أو كليهما.

مخططات الطلب والاستجابة الكاملة موجودة في API reference.

Fetch the current settings

curl https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."

يعيد الإعدادات النشطة الكاملة للمشروع، بما في ذلك أي preset مطبّق.

Patch the settings

يقبل PATCH أي مجموعة فرعية من presetId وsettings. عند تمريرهما معًا، يتم تطبيق الـ preset أولًا ثم يتم دمج settings فوقه.

Apply a preset
Inline settings
Preset + overrides

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123"
  }'

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 },
      "style": {
        "background": {
          "type": "color",
          "color": "#101010"
        }
      }
    }
  }'

curl -X PATCH https://api.youka.io/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 }
    }
  }'

Discover valid fields

تقوم الـ SDK بتصدير المخطط الذي يتحقق من صحة تحديثات إعدادات المشروع. حوّله إلى JSON Schema وقت التشغيل:

import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

ينبغي على الوكلاء جلب مخطط الـ SDK أو مخطط طلب OpenAPI قبل تعديل إعدادات المشروع كي يعرفوا دائمًا البنية الحالية.

مرجع سهل القراءة:

Project settings vs presets vs export overrides

توفّر Youka ثلاث طبقات يمكن أن تعيش فيها إعدادات العرض:

Layer	Scope	When to use
Preset	على مستوى الحساب	نفس المظهر عبر العديد من المشاريع.
Project settings	مشروع واحد	trim أو background أو color خاصة بالمشروع.
Export `settingsOverride`	عملية تصدير واحدة فقط	ضبط عرض واحد دون لمس المشروع.

يتم دمج كل طبقة بهذا الترتيب وقت التصدير.

What’s next

Render settings reference — جميع مسارات الحقول المشتركة وقيم enum
Presets — إعدادات قابلة لإعادة الاستخدام
Media — تتم الإشارة إليها من الإعدادات
CLI projects — نفس التدفق من الطرفية
SDK project settings — نفس endpoints في TypeScript

Choose a version

يعرض GET /projects/{projectId}/versions إصدارات المشروع. أضف ?versionId=ver_example إلى طلب GET الخاص بالإعدادات، أو ضمّن versionId داخل جسم PATCH، لاختيار إصدار. تتضمن استجابات الإعدادات versionId. تجاهله يحافظ على سلوك الإصدار الأساسي. تقبل طلبات التصدير أيضًا versionId. اختيار المحاذاة يعود للمشروع وهو مشترك عبر الإصدارات. راجع Automate lyric videos لمراجعات التوقيت ولقطات التصدير.

Overview

How To

Customization

Audio

Settings

Exporting

Account

إعدادات المشروع

Endpoints

Fetch the current settings

Patch the settings

Discover valid fields

Project settings vs presets vs export overrides

What’s next

Choose a version

​Endpoints

​Fetch the current settings

​Patch the settings

​Discover valid fields

​Project settings vs presets vs export overrides

​What’s next

​Choose a version

Endpoints

Fetch the current settings

Patch the settings

Discover valid fields

Project settings vs presets vs export overrides

What’s next

Choose a version