Créer une vidéo
OpenAI Sora interface de génération vidéo compatible avec les formats. Prend en charge la génération texte-vers-vidéo ainsi que les modes de génération à partir d’une image/vidéo de référence.
POST /v1/videos: Créer une tâche vidéoGET /v1/videos/{video_id}: Consulter l’état de la tâcheGET /v1/videos/{video_id}/content: obtenir le contenu binaire de la vidéo
Actuellement non disponible pour les utilisateurs externes :
GET /v1/videosPOST /v1/videos/{video_id}/remix
En-têtes d’authentification standard :
Content-Type: application/json
- Créez une tâche via
POST /v1/videoset obtenezid - Interrogez
GET /v1/videos/{id}jusqu’àcompletedoufailed - Une fois terminé, utilisez en priorité
video_urlrenvoyé dans la réponse - Si un téléchargement unifié est nécessaire, appelez
GET /v1/videos/{id}/content
Paramètres principaux :
model: string: requis, nom du modèle exposéprompt: string: recommandé, description de génération de la vidéoseconds: number|string: facultatif, durée cibleduration: number|string: facultatif, alias de duréesize: string: facultatif, taille de sortiemode: string: facultatif, valeurs courantest2vi2vi2v_first_lastreference_material
Paramètres de compatibilité courants :
aspect_ratioratioqualityresolutionfpsimageimage_urlimage_urlsimagesreference_imagesinput_referenceend_image_urllast_image_urlvideo_urlsaudio_urlsfunction_modecontentcallback_urlexternal_task_id
Paramètres d’extension courants de Kling :
model_namenegative_promptcfg_scalesoundcamera_controlimage_listvideo_idtask_idwatermark_info
4.1 série Veo
Remarque : stable, official, etc. indiquent différents groupes et ne sont pas des suffixes model exposés à l’extérieur ; lors de l’appel, veuillez conserver model comme nom de modèle de base, et le groupe réellement utilisé sera déterminé par le groupe du compte ou du jeton.
modèle principal Veo 3.x
veo3veo3-fastveo3-fast-framesveo3-framesveo3-proveo3-pro-framesveo3.1veo3.1-fastveo3.1-proveo3.1-componentsveo3.1-4kveo3.1-pro-4k
Recommandations :
- Pour la génération de vidéo à partir de texte seul, utilisez en priorité les modèles principaux
veo3*/veo3.1* - Pour les scénarios de génération de vidéo à partir d’image ou avec image de référence, il est recommandé de transmettre explicitement
mode + image_url/reference_images
4.2 série Sora
Modèles de base :
sora-2sora-2-pro
Recommandations :
sora-2*convient aux appels généraux- Si vous devez utiliser des groupes tels que
stable/official, veuillez conservermodelcomme nom de modèle de base et ne pas ajouter de suffixe au nom du modèle.
4.3 série Seedance
Modèle exposé :
doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-lite-i2v-250428doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-5-pro-251215doubao-seedance-2-0-260128doubao-seedance-2-0-fast-260128
Recommandations :
- Pour la génération de vidéo à partir de texte, privilégiez
*-t2v-*oupro / fast - Pour la génération de vidéo à partir d’image, privilégiez
*-i2v-* - Pour les scénarios avec des éléments de référence complexes, utilisez en priorité
content
4.4 série vidéo Grok
Modèle exposé :
grok-imagine-1.0-videogrok-imagine-video-1.5-previewgrok-video-3
Paramètres courants :
promptratio/aspect_ratioresolution/sizeseconds/durationimage/image_url/input_referencereference_images
Exemple :
{
"model": "grok-imagine-1.0-video",
"prompt": "雨夜霓虹街道上的电影感推镜,光影丰富,运动自然",
"reference_images": [
"https://example.com/ref-1.jpg"
],
"seconds": 10,
"aspect_ratio": "16:9",
"resolution": "720P"
}
4.5 modèle principal vidéo Kling
Modèle principal exposé :
kling-video
Obligatoire :
modelmodel_name
model_name pris en charge :
kling-v1kling-v1-5kling-v1-6kling-v2-masterkling-v2-1kling-v2-1-masterkling-v2-5-turbokling-v2-6kling-v3
mode courants :
t2vi2vmulti_i2vextend
Paramètres d’entrée minimaux :
- Génération de vidéo à partir de texte :
model + model_name + prompt + mode=t2v - Génération de vidéo à partir d’image :
model + model_name + prompt + mode=i2v + image - Référence multi-image :
model + model_name + prompt + mode=multi_i2v + image_list - Extension de vidéo :
model + model_name + mode=extend + video_id
Exemple :
{
"model": "kling-video",
"model_name": "kling-v2-6",
"mode": "t2v",
"prompt": "海边日落镜头,电影感,风吹长发",
"duration": 5,
"aspect_ratio": "16:9"
}
-
mode=t2v -
Entrée minimale :
model + prompt -
mode=i2v -
Entrée minimale :
model + prompt + image_url -
mode=i2v_first_last -
Entrée minimale :
model + prompt + image_url + end_image_url -
mode=reference_images -
Entrée minimale :
model + prompt + reference_images -
mode=reference_material -
Entrée minimale :
model + prompt + (image_urls/video_urls/audio_urls 至少一种)
Instructions d’appel Gemini Omni
gemini-omniest le nom public du modèle vidéo de new-api, utilisable directement viaPOST /v1/videos.mode=t2v: génération texte-vers-vidéo, le paramètre d’entrée minimal estmodel + prompt.mode=r2v: génération à partir d’une image/ressource de référence ; l’image peut être placée dansimage,image_url,images,image_urls,reference_images,input_referenceoucontent.mode=edit: édition vidéo ; la vidéo peut être placée dansvideo,video_url,videosoucontent, et une image de référence peut également être fournie.- Le champ de durée peut utiliser
secondsouduration; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.
Autorisations
Utilisez l'authentification Bearer Token.
Format : Authorization: Bearer sk-xxxxxx
Corps
Obligatoire, nom du modèle exposé à l’extérieur. gemini-omni Peut être appelé via /v1/videos.
sora-2, sora-2-pro, gemini-omni, happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, doubao-seedance-1-0-lite-i2v-250428, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, veo3, veo3-fast, veo3-fast-frames, veo3-frames, veo3-pro, veo3-pro-frames, veo3.1, veo3.1-4k, veo3.1-components, veo3.1-fast, veo3.1-pro, veo3.1-pro-4k, kling-video, grok-imagine-1.0-video, grok-imagine-video-1.5-preview, grok-video-3, viduq3-turbo, hailuo-video "sora-2"
Point d’entrée unifié pour les prompts. Requis pour la plupart des modèles.
Point d'entrée pour image unique ; certains modes de compatibilité seront mappés sur images.
Paramètre de durée unifié ; certains modèles acceptent également seconds.
Video width
512
Video height
512
Video frame rate
30
Random seed
20231234
Number of videos to generate
1
Response format
"url"
User identifier
"user-1234"
Conteneur de champs d'extension dynamiques. De nombreux champs spécifiques au modèle sont désérialisés à partir d'ici.
Facultatif, mode de génération vidéo. gemini-omni prend en charge t2v, r2v et edit.
Point d’entrée unifié pour plusieurs images. Utilisé par Vidu, Seedance, Veo, etc.
Point d’entrée unifié pour la taille, qui sera mappé vers resolution/aspect_ratio, etc.
Sora point d’entrée de compatibilité, au moment de l’exécution, la valeur de secours sera duration.
Point d’entrée d’image de référence compatible Sora/Veo, peut être un fichier multipart ou un objet compatible.
Réponse
Tâche vidéo créée avec succès
Should use VideoStatus constants: VideoStatusQueued, VideoStatusInProgress, VideoStatusCompleted, VideoStatusFailed
queued, in_progress, completed, failed, video_url, url, completed_at Compatible avec l'ancienne interface, bientôt obsolète
