Saltar al contenido principal
PATCH
/
projects
/
{projectId}
Update project metadata
curl --request PATCH \
  --url https://api.youka.io/api/v1/projects/{projectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "artists": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "title": "<string>",
  "artists": [
    "<string>"
  ],
  "stems": [
    {
      "id": "<string>",
      "type": "original",
      "model": "<string>",
      "url": "<string>",
      "duration": 123
    }
  ],
  "alignments": [
    {
      "id": "<string>",
      "model": "<string>",
      "alignment": "<unknown>",
      "createdAt": "<string>"
    }
  ],
  "exports": [
    {
      "id": "<string>",
      "status": "created",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "fileId": "<string>",
      "fileKey": "<string>",
      "fileSize": 123,
      "resolution": "<string>",
      "quality": "<string>",
      "transparent": true
    }
  ],
  "settings": {
    "presetId": "<string>",
    "preset": {
      "aspectRatio": "16:9",
      "layout": {
        "type": "karaoke",
        "linesPerScreen": 2,
        "alignment": "bottom",
        "paddingHorizontal": 0,
        "paddingVertical": 5,
        "languageSpacing": 5,
        "containerHeight": 100,
        "lineTransition": "fade",
        "anticipationBuffer": 3
      },
      "background": {
        "type": "auto"
      },
      "singerTextStyles": {},
      "overlays": {
        "branding": {
          "logo": {
            "enabled": false,
            "position": "bottom-right",
            "paddingX": 20,
            "paddingY": 20,
            "scale": 0.1,
            "opacity": 1
          },
          "intro": {
            "enabled": false,
            "durationSeconds": 0,
            "effect": "fade",
            "effectDuration": 0.5
          },
          "outro": {
            "enabled": false,
            "durationSeconds": 0,
            "effect": "fade",
            "effectDuration": 0.5
          }
        },
        "titleCard": {
          "enabled": true,
          "duration": 5,
          "titleStyle": {
            "fontFamily": "Arimo",
            "fontSize": 200,
            "fontWeight": 700,
            "textColor": "#2185D0",
            "outlineColor": "#000000",
            "outlineWidth": 30
          },
          "artistStyle": {
            "fontFamily": "Arimo",
            "fontSize": 150,
            "fontWeight": 700,
            "textColor": "#FFFFFF",
            "outlineColor": "#000000",
            "outlineWidth": 30
          }
        },
        "leadIn": {
          "enabled": true,
          "beats": 4,
          "minGap": 3,
          "useNextSingerStyle": true,
          "style": {
            "color": "#2185D0",
            "outlineColor": "#000000",
            "outlineWidth": 3
          },
          "width": 0.2,
          "height": 1,
          "offsetX": -2,
          "offsetY": 0
        },
        "instrumentalBreak": {
          "hideLyrics": true,
          "minGap": 5,
          "displayDuration": 3
        },
        "breakCountdown": {
          "enabled": true,
          "maxDuration": 3,
          "animation": "fade",
          "useNextSingerStyle": false,
          "style": {
            "color": "#FFFFFF",
            "outlineColor": "#000000",
            "outlineWidth": 14.5
          },
          "textSize": 80,
          "hideBeforeEnd": 0
        },
        "breakProgressBar": {
          "enabled": true,
          "maxDuration": 10,
          "useNextSingerStyle": false,
          "style": {
            "color": "#2185D0",
            "outlineColor": "#000000",
            "outlineWidth": 5,
            "backgroundColor": "#FFFFFF",
            "fillColor": "#2185D0"
          },
          "width": 47,
          "height": 7.5,
          "position": "center",
          "hideBeforeEnd": 0
        }
      },
      "trim": {
        "startSeconds": 0,
        "endSeconds": 0
      },
      "languageTextStyles": {},
      "chordTextStyle": {
        "fontFamily": "Arimo",
        "fontSize": 96,
        "fontWeight": 700,
        "textColor": "#FFFFFF",
        "outlineColor": "#000000",
        "outlineWidth": 20,
        "textEffect": "karaoke",
        "activeLineColor": "#fff09a",
        "effectColor": "#2185D0",
        "backgroundColor": "transparent",
        "letterSpacing": 0,
        "lineSpacing": 1.2,
        "textCase": "none",
        "textDirection": "auto",
        "shadowColor": "rgba(0,0,0,0.5)",
        "shadowBlur": 4,
        "shadowOffsetX": 0,
        "shadowOffsetY": 0,
        "duetPosition": "center",
        "shadowOpacity": 123
      }
    },
    "settings": {
      "style": {
        "aspectRatio": "16:9",
        "layout": {
          "type": "karaoke",
          "linesPerScreen": 2,
          "alignment": "bottom",
          "paddingHorizontal": 0,
          "paddingVertical": 5,
          "languageSpacing": 5,
          "containerHeight": 100,
          "lineTransition": "fade",
          "anticipationBuffer": 3
        },
        "background": {
          "type": "auto"
        },
        "singerTextStyles": {},
        "overlays": {
          "branding": {
            "logo": {
              "enabled": false,
              "position": "bottom-right",
              "paddingX": 20,
              "paddingY": 20,
              "scale": 0.1,
              "opacity": 1
            },
            "intro": {
              "enabled": false,
              "durationSeconds": 0,
              "effect": "fade",
              "effectDuration": 0.5
            },
            "outro": {
              "enabled": false,
              "durationSeconds": 0,
              "effect": "fade",
              "effectDuration": 0.5
            }
          },
          "titleCard": {
            "enabled": true,
            "duration": 5,
            "titleStyle": {
              "fontFamily": "Arimo",
              "fontSize": 200,
              "fontWeight": 700,
              "textColor": "#2185D0",
              "outlineColor": "#000000",
              "outlineWidth": 30
            },
            "artistStyle": {
              "fontFamily": "Arimo",
              "fontSize": 150,
              "fontWeight": 700,
              "textColor": "#FFFFFF",
              "outlineColor": "#000000",
              "outlineWidth": 30
            }
          },
          "leadIn": {
            "enabled": true,
            "beats": 4,
            "minGap": 3,
            "useNextSingerStyle": true,
            "style": {
              "color": "#2185D0",
              "outlineColor": "#000000",
              "outlineWidth": 3
            },
            "width": 0.2,
            "height": 1,
            "offsetX": -2,
            "offsetY": 0
          },
          "instrumentalBreak": {
            "hideLyrics": true,
            "minGap": 5,
            "displayDuration": 3
          },
          "breakCountdown": {
            "enabled": true,
            "maxDuration": 3,
            "animation": "fade",
            "useNextSingerStyle": false,
            "style": {
              "color": "#FFFFFF",
              "outlineColor": "#000000",
              "outlineWidth": 14.5
            },
            "textSize": 80,
            "hideBeforeEnd": 0
          },
          "breakProgressBar": {
            "enabled": true,
            "maxDuration": 10,
            "useNextSingerStyle": false,
            "style": {
              "color": "#2185D0",
              "outlineColor": "#000000",
              "outlineWidth": 5,
              "backgroundColor": "#FFFFFF",
              "fillColor": "#2185D0"
            },
            "width": 47,
            "height": 7.5,
            "position": "center",
            "hideBeforeEnd": 0
          }
        },
        "trim": {
          "startSeconds": 0,
          "endSeconds": 0
        },
        "languageTextStyles": {},
        "chordTextStyle": {
          "fontFamily": "Arimo",
          "fontSize": 96,
          "fontWeight": 700,
          "textColor": "#FFFFFF",
          "outlineColor": "#000000",
          "outlineWidth": 20,
          "textEffect": "karaoke",
          "activeLineColor": "#fff09a",
          "effectColor": "#2185D0",
          "backgroundColor": "transparent",
          "letterSpacing": 0,
          "lineSpacing": 1.2,
          "textCase": "none",
          "textDirection": "auto",
          "shadowColor": "rgba(0,0,0,0.5)",
          "shadowBlur": 4,
          "shadowOffsetX": 0,
          "shadowOffsetY": 0,
          "duetPosition": "center",
          "shadowOpacity": 123
        }
      },
      "trim": {
        "startSeconds": 0,
        "endSeconds": 0
      },
      "displayLanguages": [
        "<string>"
      ],
      "chordSettings": {
        "displayMode": "inline",
        "notation": "chord_simple_pop",
        "transpose": 0,
        "capo": 0,
        "showLayer": true
      },
      "duetSingerFilter": {
        "enabled": false,
        "selectedSingerIds": [],
        "includeSharedLines": true
      }
    }
  },
  "lyrics": "<string>",
  "language": "<string>",
  "duration": 123,
  "task": {
    "id": "<string>",
    "type": "create-karaoke",
    "status": "created",
    "error": "<string>"
  }
}

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Idempotency-Key
string

Parámetros de ruta

projectId
string
requerido

Cuerpo

application/json
title
string
Minimum string length: 2
artists
string[]
Minimum string length: 1

Respuesta

200 - application/json

Updated project state

id
string
requerido
title
string
requerido
artists
string[]
requerido
stems
object[]
requerido
alignments
object[]
requerido
exports
object[]
requerido
settings
object
requerido
lyrics
string | null
language
string | null
duration
number | null
task
object