Paramètres du projet

Chaque projet possède des paramètres actifs — trim, background, style de sous-titres, layout — qui contrôlent la façon dont les exports sont rendus. Utilisez les paramètres du projet lorsque vous souhaitez des surcharges locales au projet qui ne valent pas la peine d’être partagées en tant que preset. Voir Render settings reference pour la cartographie des champs partagés preset, settings.style et settingsOverride.

Endpoints

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	Récupérer les paramètres actifs du projet.
`PATCH`	`/projects/{projectId}/settings`	Appliquer un preset, modifier des paramètres, ou les deux.

Les schémas complets de requête et de réponse se trouvent dans la API reference.

Récupérer les paramètres actuels

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

Renvoie l’ensemble complet des paramètres actifs du projet, y compris tout preset appliqué.

Modifier les paramètres

PATCH accepte n’importe quel sous-ensemble de presetId et settings. Lorsque les deux sont fournis, le preset est appliqué en premier puis settings est fusionné par-dessus.

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 }
    }
  }'

Découvrir les champs valides

Le SDK exporte le schéma qui valide les mises à jour des paramètres de projet. Convertissez-le en JSON Schema à l’exécution :

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Les agents devraient récupérer le schéma du SDK ou le schéma de requête OpenAPI avant de modifier les paramètres du projet afin de toujours connaître la forme actuelle.

Référence lisible :

Paramètres de projet vs presets vs surcharges d’export

Youka propose trois couches où les paramètres de rendu peuvent se trouver :

Layer	Scope	When to use
Preset	À l’échelle du compte	Le même rendu sur de nombreux projets.
Project settings	Un seul projet	Trim, background ou couleur spécifiques au projet.
Export `settingsOverride`	Un seul export	Ajuster un seul rendu sans toucher au projet.

Chaque couche est fusionnée dans cet ordre au moment de l’export.

Et ensuite

Render settings reference — tous les chemins de champs partagés et les valeurs d’enum
Presets — configurations réutilisables
Media — référencé depuis les paramètres
CLI projects — le même flux depuis le terminal
SDK project settings — les mêmes endpoints en TypeScript

Choisir une version

GET /projects/{projectId}/versions liste les versions du projet. Ajoutez ?versionId=ver_example à la requête GET des paramètres, ou incluez versionId dans le body du PATCH, pour choisir une version. Les réponses de paramètres incluent versionId. L’omettre conserve le comportement de version principale. Les requêtes d’export acceptent également versionId. La sélection d’alignement appartient au projet et est partagée entre les versions. Voir Automate lyric videos pour les révisions de timing et les instantanés d’export.

Overview

How To

Customization

Audio

Settings

Exporting

Account

Paramètres du projet

Endpoints

Récupérer les paramètres actuels

Modifier les paramètres

Découvrir les champs valides

Paramètres de projet vs presets vs surcharges d’export

Et ensuite

Choisir une version

​Endpoints

​Récupérer les paramètres actuels

​Modifier les paramètres

​Découvrir les champs valides

​Paramètres de projet vs presets vs surcharges d’export

​Et ensuite

​Choisir une version

Endpoints

Récupérer les paramètres actuels

Modifier les paramètres

Découvrir les champs valides

Paramètres de projet vs presets vs surcharges d’export

Et ensuite

Choisir une version