ForHosting KIT · Audio et voix

Calculer l’horodatage des publicités d’un podcast

Transformez la durée d’un épisode et trois positions publicitaires exprimées en pourcentage en horaires exacts, prêts pour la production.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez la durée en secondes, choisissez entre 0 et 100 pour cent où placer le pre-roll, le mid-roll et le post-roll, puis obtenez des décalages numériques et des codes temporels lisibles. Le calcul étant déterministe, les équipes de production, de régie publicitaire et de publication peuvent appliquer les mêmes règles sans parcourir manuellement chaque épisode.

Convertissez les pourcentages de campagne en horaires de montage

Les plans publicitaires des podcasts définissent souvent les emplacements en pourcentage, car une position relative s’adapte facilement à des épisodes de durées différentes. Une consigne telle que « placez le mid-roll à 50 pour cent » est simple à normaliser, mais le monteur ou le système de publication a toujours besoin d’un code temporel précis. Ce calculateur multiplie la durée de l’épisode par chaque pourcentage demandé et renvoie le décalage en secondes avec un horodatage HH:MM:SS.mmm lisible. Saisissez la durée totale en secondes, puis un pourcentage pour le pre-roll, le mid-roll et le post-roll. Pour un épisode de 3,600 secondes, 2.5 pour cent donne 90 secondes, 50 pour cent donne 1,800 secondes et 97.5 pour cent donne 3,510 secondes. Chaque résultat reste associé à son rôle afin de limiter les erreurs de copie. Puisque le calcul est toujours identique, la sortie convient aux notes de production, manifestes d’insertion, feuilles de validation et automatisations qui exigent des repères cohérents sur tout un catalogue.

Maîtrisez la précision, les limites et la validation

Chaque pourcentage est mesuré depuis le début de l’épisode. Ainsi, 0 pour cent correspond à l’ouverture et 100 pour cent à la durée exacte de l’épisode. Les valeurs intermédiaires donnent des positions proportionnelles, y compris les fractions comme 12.5 ou 87.25. Les décalages numériques comportent jusqu’à six décimales et les codes temporels affichés sont arrondis à la milliseconde la plus proche, précision courante dans les interfaces de montage audio et de publication. Le calculateur refuse tout pourcentage inférieur à 0 ou supérieur à 100 au lieu de le ramener silencieusement dans l’intervalle. Une telle correction pourrait déplacer une publicité tout en laissant croire que la demande a réussi. Les durées absentes, non numériques, infinies ou non positives sont également rejetées. Ces contrôles révèlent les erreurs avant que les repères n’entrent dans le flux d’insertion. L’outil ne juge pas la pertinence éditoriale, ne détecte pas les silences et ne déplace pas un repère pour éviter une parole ou une musique : il effectue précisément la conversion demandée.

Intégrez les résultats au flux de production

La liste renvoyée suit l’ordre pre-roll, mid-roll et post-roll. Chaque entrée contient le pourcentage d’origine, le décalage numérique en secondes et le code temporel formaté. Une personne chargée de la production peut copier la valeur lisible dans une liste de montage ou une fiche d’épisode, tandis qu’une intégration utilise directement le décalage sans analyser une chaîne de caractères. Cette double représentation est pratique lorsqu’une équipe vérifie visuellement les emplacements et qu’une autre transmet des données structurées au serveur publicitaire. Pour une émission récurrente, conservez les pourcentages de campagne comme règle stable et traitez la durée de chaque nouvel épisode avec le calculateur. L’espacement relatif reste ainsi conforme même si la durée varie chaque semaine. Avant publication, vérifiez les repères sur le fichier master définitif plutôt que sur un premier montage : raccourcir l’introduction ou ajouter un générique modifie la durée totale et toutes les positions proportionnelles. Le tarif de l’API est de $0.002 par requête et la version navigateur utilise la même logique. Aucun fichier audio n’est transmis.

Préparer une fiche d’insertion publicitaire

Convertissez le plan en pourcentages d’un annonceur en horaires que le monteur peut reporter directement dans la fiche de l’épisode.

Uniformiser les emplacements d’une série

Appliquez la même règle relative de pre-roll, mid-roll et post-roll à des épisodes dont la durée finale varie.

Alimenter une publication automatisée

Utilisez les décalages numériques dans une intégration tout en gardant des codes lisibles pour la validation humaine.

Quel est le prix du calculateur via l’API ?

Chaque requête API coûte $0.002. Vous pouvez aussi effectuer le calcul dans le navigateur avec la même logique déterministe.

Quelle unité faut-il utiliser pour la durée ?

Saisissez la durée complète en secondes. Les secondes décimales sont acceptées lorsque la source fournit une précision inférieure à la seconde.

Un pourcentage peut-il valoir exactement 0 ou 100 ?

Oui. La valeur 0 désigne le début de l’épisode et 100 correspond exactement à son instant final.

Que se passe-t-il si un pourcentage sort de l’intervalle ?

La requête renvoie une erreur d’entrée non valide qui identifie le champ concerné. Aucune valeur n’est tronquée ni réajustée.

Quelle est la précision des horaires renvoyés ?

Les décalages conservent jusqu’à six décimales et le code temporel lisible est arrondi à la milliseconde la plus proche.

L’outil analyse-t-il ou téléverse-t-il le son du podcast ?

Non. Il utilise uniquement la durée et les pourcentages fournis ; aucun fichier audio n’est reçu, analysé ou conservé.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/audio/podcast-ad-slot-timing

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/audio/podcast-ad-slot-timing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_seconds":3600,"pre_roll_percent":2.5,"mid_roll_percent":50,"post_roll_percent":97.5}'
{
  "duration_seconds": 3600,
  "pre_roll_percent": 2.5,
  "mid_roll_percent": 50,
  "post_roll_percent": 97.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "audio.podcast_ad_slot_timing",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_mb200
max_minutes180
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →