https://gateway.streamfizz.live/apiTraduit une piste de sous-titres vers une ou plusieurs langues. Une piste est créée par langue cible, en statut Pending. Consomme le quota de caractères traduits.
| Nom | Type | Description |
|---|---|---|
mediaId* | ID! | Média auquel la piste source est rattachée. |
subtitleId* | ID! | Piste source. Doit être en statut Ready, et sa langue doit elle-même porter l'opération Translate — voir getLanguages. |
targetLanguages* | [Language!]! | Langues cibles, portant l'opération Translate — voir getLanguages. Chaque langue une seule fois, et différente de la langue de la piste source. |
Media| Nom | Type | Description |
|---|---|---|
id | ID! | Identifiant unique du média. |
title | String | Titre du média. |
type | MediaType | Type de média. |
sourceKey | String | Clé S3 du fichier source original. |
fileName | String! | Nom du fichier source. Pour un média créé par l'API depuis une URL, c'est
le dernier segment de l'URL normalisé : minuscules, espaces et caractères
spéciaux remplacés par des tirets ( |
cote | String | Cote ou référence métier interne. |
note | String | Note interne sur le média. |
myCapability | AuthzCapability! | Ce que l'appelant a le droit de faire sur ce contenu, compte tenu de ses
groupes et de ses accès directs : |
encodingVersion | String | Version actuelle d'encodage (ex: "v0", "v2.1"). |
isEncoding | Boolean! | Un encodage de la version courante est en cours. Faux pour un média sans encodage lancé (créé sans fichier) ou en version v0. |
duration | Float | Durée du média en secondes. Vaut 0 tant que l'encodage ne l'a pas mesurée. |
ratio | Float | Ratio d'aspect (largeur / hauteur). |
playlistKey | String | Clé S3 de la playlist HLS. |
playlistCdnUrl | String | URL CDN de la playlist HLS. |
thumbKeys | [String] | Clés S3 des miniatures générées. |
thumbCdnUrls | [String] | URLs CDN des miniatures générées. |
selectedThumbKey | String | Clé S3 de la miniature sélectionnée. |
selectedThumbCdnUrl | String | URL CDN de la miniature sélectionnée. |
thumbnailVttCdnUrl | String | URL CDN du fichier VTT des vignettes de prévisualisation. |
deltaChapter | Int | Décalage en secondes appliqué aux points de chapitre à la lecture, pour rattraper la latence d'encodage et de diffusion. |
publicUrl | String | URL de la page de lecture publique. |
publicEmbedUrl | String | URL d'intégration (embed) publique. |
publisher | User! | Utilisateur ayant publié le média. |
account | Account | Compte propriétaire du média. |
accessGroups | [Group!]! | - |
directUsers | [PublicUser!]! | - |
createdAt | DateTime! | Date de création du média. |
updatedAt | DateTime! | Date de dernière modification du média. |
encoding | Encoding! | État d'encodage de la version servie. |
pendingEncoding | Encoding | Ré-encodage en cours, s'il y en a un : il remplacera la version servie une fois terminé. Null sinon. |
mediaInfos | Json | Infos techniques d'encodage (ffprobe-like pour v1+, array typé pour v0 legacy). |
subtitles | [Subtitle!] | Sous-titres associés au média. |
files | [File!] | Fichiers joints au média. |
chapters | [Chapter] | Chapitres associés au média. |
clips | [Clip!] | Clips dérivés du média. |
live | Live | Live associé si ce média est un replay. |
discussion | Discussion | Discussion (chat) associée au média. |
moderatorContents | [ModeratorContent] | Modérateurs désignés pour ce média. |
relatedTags | [Tag] | Tags rattachés. |
relatedCategories | [Category] | Catégories rattachées. |
pageSetting | BrandSetting | Paramètres de personnalisation de la page de lecture. |
embedSetting | BrandSetting | Paramètres de personnalisation de l'embed. |
preRoll | RollPreset | Annonce intro associée. |
postRoll | RollPreset | Annonce outro associée. |
seo | SEO | Paramètres SEO de la page de lecture. |
confidentiality | Confidentiality | Niveau de confidentialité (nouveau modèle). |
privacy | Privacy | Inscription des spectateurs. |
playlists | PlaylistConnection | Playlists contenant ce média. |
webTVs | WebTVConnection | WebTVs contenant ce média. |
metadata | MediaMetadata | Métadonnées descriptives (production, auteur, contenu). |
originalPublisher | DeletedUser | - |
Le traitement se fait en arrière-plan et rien ne vous rappellera : la piste revient en statut Pending, puis passe à Processing et enfin Ready. Relisez-la sur le média pour suivre son avancement — quelques secondes suffisent entre deux appels, une transcription se compte en minutes.
{
getMedia(id: "MEDIA_ID") {
subtitles {
id
label
languages
source
status
cdnUrl
}
}
}cdnUrl reste null tant que le statut n'est pas Ready. Un statut Error est définitif : la piste ne se reprendra pas toute seule.| Code | Message | Description |
|---|---|---|
UNAUTHENTICATED | Invalid or expired API key | Clé API manquante ( |
API_ADDON_REQUIRED | This account does not have the API addon | La clé est valide mais le compte n'a pas l'option API. La réponse porte un code HTTP 403 ; la requête n'est pas exécutée. |
INPUT_VALIDATION_ERROR | Validation failed: {field}: {message} | Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[]. Tout argument texte qui n'est pas de l'Unicode valide — caractère NUL ( |
GRAPHQL_VALIDATION_FAILED | Query depth limit of 10 exceeded, found {depth}. | Le document ne respecte pas le schéma : champ ou argument inconnu, valeur écrite en dur dans la requête qui n'a pas le type attendu (valeur d'enum inexistante…), ou limite par requête dépassée (profondeur, coût, alias, directives — voir Rate Limiting). La réponse porte un code HTTP 400 ; rien n'est exécuté. |
BAD_USER_INPUT | Variable "$name" got invalid value {value}; {reason} | Une variable ( |
INTERNAL_SERVER_ERROR | Internal server error | Erreur interne du serveur. Le message est volontairement générique : le détail est journalisé côté Streamfizz, jamais renvoyé. |
| Code | Message | Description |
|---|---|---|
SUBTITLE_NOT_TRANSLATABLE | Source subtitle has no file to translate yet | La piste source n'a pas encore de fichier : une transcription en cours ne peut pas être traduite. |
LANGUAGE_NOT_TRANSLATABLE | Language '{language}' does not support Translate | Une des langues cibles, ou la langue de la piste source, n'est pas traduisible. |
QUOTA_EXCEEDED | The quota for TRANSLATE_CHARACTER has been exceeded | Le quota de caractères traduits du compte est atteint. Il est calculé sur la longueur de la piste source multipliée par le nombre de langues cibles. |
NOT_FOUND | Subtitle '{id}' has not been found on this media | La piste source n'existe pas, a été supprimée, ou n'est pas rattachée à ce média |
INPUT_VALIDATION_ERROR | Validation failed: targetLanguages: Each target language may appear only once | Une langue figure deux fois dans |
Validation failed: targetLanguages: Target language '{language}' is the language of the source subtitle | Une des |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.