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éo
• GET /v1/videos/{video_id} : Consulter l’état de la tâche
• GET /v1/videos/{video_id}/content : obtenir le contenu binaire de la vidéo

Actuellement non disponible pour les utilisateurs externes :

• GET /v1/videos
• POST /v1/videos/{video_id}/remix

En-têtes d’authentification standard :

• Content-Type: application/json

1. Créez une tâche via POST /v1/videos et obtenez id
2. Interrogez GET /v1/videos/{id} jusqu’à completed ou failed
3. Une fois terminé, utilisez en priorité video_url renvoyé dans la réponse
4. 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éo
• seconds: number|string : facultatif, durée cible
• duration: number|string : facultatif, alias de durée
• size: string : facultatif, taille de sortie
• mode: string : facultatif, valeurs courantes t2v i2v i2v_first_last reference_material

Paramètres de compatibilité courants :

• aspect_ratio
• ratio
• quality
• resolution
• fps
• image
• image_url
• image_urls
• images
• reference_images
• input_reference
• end_image_url
• last_image_url
• video_urls
• audio_urls
• function_mode
• content
• callback_url
• external_task_id

Paramètres d’extension courants de Kling :

• model_name
• negative_prompt
• cfg_scale
• sound
• camera_control
• image_list
• video_id
• task_id
• watermark_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

• veo3
• veo3-fast
• veo3-fast-frames
• veo3-frames
• veo3-pro
• veo3-pro-frames
• veo3.1
• veo3.1-fast
• veo3.1-pro
• veo3.1-components
• veo3.1-4k
• veo3.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-2
• sora-2-pro

Recommandations :

• sora-2* convient aux appels généraux
• Si vous devez utiliser des groupes tels que stable / official, veuillez conserver model comme nom de modèle de base et ne pas ajouter de suffixe au nom du modèle.

Exemple de requête :

{
  "size": "1280x720",
  "images": [
    "https://example.png"
  ],
  "model": "sora-2",
  "prompt": "this is an example",
  "duration": 12,
  "fps": "24",
  "seed": "20231024",
  "mode": "i2v"
}

4.3 Série HappyHorse

Modèle exposé :

• happyhorse-1.0

Recommandations :

• happyhorse-1.0 différenciés par mode : t2v, i2v, r2v et video_edit.
• Dans le format compatible Sora, il est recommandé d’utiliser un tableau content pour transmettre les éléments multimédias.
• Les éléments texte utilisent type=text, les éléments multimédias utilisent type=image_url et peuvent être associés à role et name pour indiquer l’usage du contenu.

Exemple de requête :

{
  "size": "720x1280",
  "model": "happyhorse-1.0",
  "mode": "r2v",
  "prompt": "this is an example",
  "duration": 15,
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    }
  ],
  "parameters": {
    "resolution": "720P",
    "ratio": "9:16",
    "duration": 15,
    "seed": 1
  }
}

4.4 Série Seedance

Modèle exposé :

• doubao-seedance-1-0-lite-t2v-250428
• doubao-seedance-1-0-lite-i2v-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

Recommandations :

• Pour la génération de vidéo à partir de texte, privilégiez *-t2v-* ou pro / 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

Exemple de requête :

{
  "size": "1280x720",
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "this is an example",
  "duration": 15,
  "fps": "24",
  "seed": "20231024",
  "mode": "reference_material",
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.mp3"
      },
      "role": "reference_audio",
      "name": "audio1"
    }
  ]
}

4.5 Série vidéo Grok

Modèle exposé :

• grok-imagine-1.0-video
• grok-imagine-video-1.5-preview
• grok-video-3

Paramètres courants :

• prompt
• ratio / aspect_ratio
• resolution / size
• seconds / duration
• image / image_url / input_reference
• reference_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.6 Modèle principal vidéo Kling

Modèle principal exposé :

• kling-video

Obligatoire :

• model
• model_name

model_name pris en charge :

• kling-v1
• kling-v1-5
• kling-v1-6
• kling-v2-master
• kling-v2-1
• kling-v2-1-master
• kling-v2-5-turbo
• kling-v2-6
• kling-v3

mode courants :

• t2v
• i2v
• multi_i2v
• extend

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"
}

4.7 Série vidéo MiniMax / Hailuo

Modèle exposé :

• minimax-h3
• hailuo-2.3

Recommandations :

• minimax-h3 prend en charge la génération de vidéo à partir de texte, les références d’image et les références audio ; il est recommandé d’utiliser content pour mélanger texte et ressources ; vous pouvez aussi utiliser des champs compatibles tels que image_urls et audio_urls.
• hailuo-2.3 nécessite une image de première image ; il est recommandé de transmettre l’élément image_url de role=first_frame dans content, ou d’utiliser image_urls pour transmettre l’image de première image.
• minimax-h3 utilise généralement duration=5~15 et resolution=1440p ; hailuo-2.3 utilise généralement duration=6 ou 10 et resolution=768p.

Exemple minimax-h3 :

{
  "model": "minimax-h3",
  "prompt": "A cinematic product video with smooth camera motion",
  "content": [
    {
      "type": "text",
      "text": "Use the product image as reference and match the rhythm of the audio."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.jpg"
      },
      "role": "reference_image",
      "name": "product"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/music.mp3"
      },
      "role": "reference_audio",
      "name": "music"
    }
  ],
  "duration": 8,
  "resolution": "1440p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

Exemple hailuo-2.3 :

{
  "model": "hailuo-2.3",
  "prompt": "The camera slowly pushes in, natural motion and cinematic lighting.",
  "content": [
    {
      "type": "text",
      "text": "The camera slowly pushes in, natural motion and cinematic lighting."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame",
      "name": "first"
    }
  ],
  "duration": 10,
  "resolution": "768p",
  "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-omni est le nom public du modèle vidéo de new-api, utilisable directement via POST /v1/videos.
• mode=t2v : génération texte-vers-vidéo, le paramètre d’entrée minimal est model + prompt.
• mode=r2v : génération à partir d’une image/ressource de référence ; l’image peut être placée dans image, image_url, images, image_urls, reference_images, input_reference ou content.
• mode=edit : édition vidéo ; la vidéo peut être placée dans video, video_url, videos ou content, et une image de référence peut également être fournie.
• Le champ de durée peut utiliser seconds ou duration ; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.