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

# Paramètres du projet

> Lire et modifier les paramètres actifs d'un projet

Chaque projet possède des paramètres actifs — découpe, arrière-plan, style de sous-titres, mise en page — 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 sous forme de preset.

Voir [Référence des paramètres de rendu](/en/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 les paramètres, ou les deux. |

Les schémas complets des requêtes et des réponses se trouvent dans la **référence API**.

## Récupérer les paramètres actuels

```bash theme={null}
curl https://api.youka.io/fr/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."
```

Renvoie l’ensemble 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é d’abord puis `settings` est fusionné par-dessus.

<Tabs>
  <Tab title="Apply a preset">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/fr/api/v1/projects/prj_abc/settings \
      -H "Authorization: Bearer yk_..." \
      -H "Content-Type: application/json" \
      -d '{
        "presetId": "preset_abc123"
      }'
    ```
  </Tab>

  <Tab title="Inline settings">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/fr/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"
            }
          }
        }
      }'
    ```
  </Tab>

  <Tab title="Preset + overrides">
    ```bash theme={null}
    curl -X PATCH https://api.youka.io/fr/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 }
        }
      }'
    ```
  </Tab>
</Tabs>

## Découvrir les champs valides

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

```ts theme={null}
import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();
```

<Tip>
  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 structure actuelle.
</Tip>

Référence lisible :

* [Référence des paramètres de rendu](/en/render-settings-reference)
* [Projets CLI](/fr/cli/projects)
* [Paramètres de projet SDK](/fr/sdk/project-settings)

## Paramètres du projet vs presets vs surcharges d’export

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

| Layer                         | Scope                 | When to use                                             |
| ----------------------------- | --------------------- | ------------------------------------------------------- |
| **Preset**                    | À l’échelle du compte | La même apparence sur de nombreux projets.              |
| **Project settings**          | Un seul projet        | Découpe, arrière-plan ou couleur spécifiques au projet. |
| **Export `settingsOverride`** | Un seul export        | Ajuster un rendu unique sans toucher au projet.         |

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

## Et ensuite

* [Référence des paramètres de rendu](/en/render-settings-reference) — tous les chemins de champs partagés et les valeurs d’énumération
* [Presets](/fr/api/presets) — configurations réutilisables
* [Media](/fr/api/media) — référencés depuis les paramètres
* [Projets CLI](/fr/cli/projects) — le même flux depuis le terminal
* [Paramètres de projet SDK](/fr/sdk/project-settings) — les mêmes endpoints en TypeScript