Référence de l'API

Le VidioClient est le point d'entrée principal pour interagir avec l'API VIDIO depuis Python. Utilisez-le pour télécharger des fichiers, créer des travaux de montage vidéo, vérifier l'état des emplois, rendre des sorties et attendre que le traitement soit terminé.

L'accès à l'API est actuellement disponible pour le plan Studio et au-dessus.

Le modèle client

Le VidioClient fournit une interface simple pour travailler avec l'API VIDIO. Après avoir créé un client avec votre clé API, vous pouvez télécharger des fichiers d'entrée, créer des travaux de montage vidéo, interroger l'état des emplois, rendre des sorties et attendre que les travaux se terminent.

Propriétés

api_keystring

Votre clé API VIDIO utilisée pour authentifier les requêtes.

Méthodes

CLASSEVidioClient(api_key)

Initialiser le client

Crée une nouvelle instance de VidioClient.

Parameters

api_keystring

Votre clé API VIDIO.

Returns

Une instance de VidioClient configurée.

python

from vidio import VidioClient
import os

client = VidioClient(
    api_key=os.getenv("VIDIO_API_KEY")
)

MÉTHODEclient.upload(file_path)

Télécharger un fichier

Télécharge un fichier local sur VIDIO et renvoie un résultat de téléchargement contenant la clé d'entrée.

Parameters

file_pathstring

Le chemin local du fichier que vous souhaitez télécharger.

Returns

Un objet résultat de téléchargement contenant `input_key`.

python

result = client.upload("/path/to/video.mp4")
print(result.input_key)

MÉTHODEclient.create_highlight_reel(input_keys, video_category, output_length, aspect_ratio)

Créer un montage vidéo

Crée un travail de montage vidéo à partir d'un ou plusieurs fichiers d'entrée téléchargés.

Parameters

input_keyslist[string]

Une liste de clés de fichiers téléchargés retournées par upload(). L'ordre des clés d'entrée détermine l'ordre des médias dans la vidéo de sortie.

video_categorystring

Catégorie de la vidéo telle que ball-sports. Cela peut être podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others. Pour de meilleurs résultats, spécifiez la catégorie qui correspond le mieux à votre contenu. Si votre contenu ne correspond à aucune catégorie, utilisez others.

output_lengthinteger

Longueur de sortie souhaitée en secondes. La longueur de sortie doit être inférieure ou égale à la longueur totale combinée de toutes les vidéos d'entrée.

aspect_ratiostring

Rapport d'aspect de sortie tel que paysage, portrait ou carré.

Returns

Un objet de travail contenant `job_id` et des informations sur l'état.

python

job = client.create_highlight_reel(
    input_keys=[result.input_key],
    video_category="ball-sports",
    output_length=30,
    aspect_ratio="landscape",
)

print(job.job_id)
print(job.status)

MÉTHODEclient.get_job(job_id)

Obtenir un emploi

Récupère l'état actuel d'un emploi.

Parameters

job_idstring

L'ID de l'emploi retourné lorsque le travail de montage vidéo a été créé.

Returns

Un objet de travail avec le dernier état.

python

job_status = client.get_job(job.job_id)
print(job_status.status)

MÉTHODEclient.wait_for_job(job_id)

Attendre un emploi

Interroge l'API jusqu'à ce que le travail de montage vidéo atteigne un état complété.

Parameters

job_idstring

L'ID de l'emploi à attendre.

Returns

L'objet de travail final complété.

python

final_job = client.wait_for_job(job.job_id)
print(final_job.status)

MÉTHODEclient.render(job_id)

Rendre la sortie

Commence à rendre une vidéo de sortie pour un travail de montage vidéo complété.

Parameters

job_idstring

L'ID du travail de montage vidéo complété.

Returns

Un objet de résultat de rendu avec l'état de rendu.

python

render_result = client.render(
    job_id=job.job_id
)

print(render_result.status)

MÉTHODEclient.wait_for_render(job_id)

Attendre le rendu

Interroge jusqu'à ce que le rendu soit terminé et que la sortie soit prête.

Parameters

job_idstring

L'ID de l'emploi associé au rendu.

Returns

L'objet de résultat de rendu final.

python

final_render = client.wait_for_render(job.job_id)
print(final_render.output_url)