curl --request POST \
--url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seedance-1-0-lite-i2v-250428",
"mode": "reference_material",
"prompt": "测试文字",
"content": [
{
"type": "text",
"text": "测试文字"
},
{
"type": "image_url",
"image_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
},
"role": "reference_image",
"name": "1"
},
{
"type": "video_url",
"video_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
},
"role": "reference_video",
"name": "2"
},
{
"type": "audio_url",
"audio_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
},
"role": "reference_audio",
"name": "3"
}
],
"duration": 5,
"size": "1280x720"
}
'{
"id": "task_xxx",
"status": "queued",
"created_at": "<string>",
"items": "<string>"
}Créer une vidéo(Seedance)
Cette série prend en charge le format de génération vidéo OpenAI (voir le lien Formats compatibles pour la génération vidéo Sora).
Utilisé pour créer des tâches de génération vidéo et interroger leur statut et leurs résultats via l’ID de tâche.
Champs principaux pour la création de tâche :
model: Obligatoire, nom du modèle.prompt: Obligatoire, description principale pour la génération vidéo.content: facultatif, tableau content de Volcano Ark, pour mélanger du texte, des images, des vidéos et des fichiers audio.function_mode: Optionnel, couramment utilisé pour les modes avancés tels que la référence omnipotente.
Paramètres d’entrée compatibles :
Les champs suivants sont principalement utilisés pour la compatibilité avec les anciens clients et les anciens protocoles. Pour une nouvelle intégration, utilisez autant que possible le format standard de l’« exemple de requête » de cette page : le texte et les éléments de référence utilisent le tableau content, et la configuration de génération utilise les champs de niveau supérieur duration, ratio, resolution, fps, etc.
mode:t2v / i2v / i2v_first_last / reference_images / reference_materialimage_url / image_urls / input_referenceend_image_url / last_image_urlvideo_urls / audio_urlsseconds / durationaspect_ratio / ratio / sizequality / resolutionfpsgenerate_audio / watermark
Détails d’appel :
- Pour
mode=reference_materialoufunction_mode=omni_reference, il est recommandé de transmettre le texte et les éléments de référence viacontent. - Les éléments texte de
contents’écrivent sous la forme{ "type": "text", "text": "测试文字" }. - Les éléments d’images, de vidéos et d’audio de
contentutilisent respectivement les écritures d’objetimage_url,video_urletaudio_url, par exemple{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }. rolepeut identifier l’usage du média, etnamepeut être référencé par son nom dans le prompt.ratio,duration,resolutionetfpsaffectent la configuration de génération finale.
Appel Gemini Omni :
gemini-omnipeut aussi être appelé via cette interface de tâche Seedance.mode=t2vest utilisé pour la génération de vidéo à partir de texte,mode=r2vpour la génération à partir d’images/de médias de référence, etmode=editpour l’édition vidéo.- Le texte peut être placé dans l’élément
textdepromptoucontent; les images peuvent être placées dansimage_url / image_urls / reference_images / input_reference / content; les vidéos peuvent être placées dansvideo_urls / content. - Le champ de durée peut utiliser
durationouseconds; il sera automatiquement aligné sur les paliers de 4 / 6 / 8 / 10 secondes.
Appel MiniMax / Hailuo :
minimax-h3peut être appelé via cette interface de tâche et prend en charge la génération vidéo à partir de texte, les références d’image et les références audio ; le texte peut être placé dans les éléments de textepromptoucontent, et les ressources peuvent être placées dans les champscontent,image_urls,audio_urls, etc.hailuo-2.3peut être appelé via cette interface de tâche et nécessite une image de première image ; il est recommandé de transmettre l’élémentimage_urlderole=first_framedanscontent.minimax-h3utilise généralementduration=5~15etresolution=1440p;hailuo-2.3utilise généralementduration=6ou10etresolution=768p.
Champs importants des résultats de requête :
items[].statusitems[].content.video_urlouitems[].video_urlitems[].erroritems[].progress
Error fields: error.code, error.message.
{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}
curl --request POST \
--url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "doubao-seedance-1-0-lite-i2v-250428",
"mode": "reference_material",
"prompt": "测试文字",
"content": [
{
"type": "text",
"text": "测试文字"
},
{
"type": "image_url",
"image_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
},
"role": "reference_image",
"name": "1"
},
{
"type": "video_url",
"video_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
},
"role": "reference_video",
"name": "2"
},
{
"type": "audio_url",
"audio_url": {
"url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
},
"role": "reference_audio",
"name": "3"
}
],
"duration": 5,
"size": "1280x720"
}
'{
"id": "task_xxx",
"status": "queued",
"created_at": "<string>",
"items": "<string>"
}Autorisations
Utilisez l'authentification Bearer Token.
Format : Authorization: Bearer sk-xxxxxx
Corps
Obligatoire. Nom du modèle. Peut être Seedance modèle externe, gemini-omni, minimax-h3 ou hailuo-2.3.
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, minimax-h3, hailuo-2.3, gemini-omni "doubao-seedance-2-0-260128"
Obligatoire. Description principale pour la génération de la vidéo, ne peut pas être vide.
"参考素材生成一段剧情短视频"
Facultatif. Tableau content de Volcengine Ark, mélangeant dans l’ordre les éléments de texte et de média. Les éléments de texte utilisent { "type": "text", "text": "..." } ; les éléments image, vidéo et audio utilisent respectivement les objets image_url, video_url et audio_url, dans lesquels placer url. Ils peuvent être associés à role (par exemple reference_image, reference_video, reference_audio) et à name pour les références dans le texte.
Hide child attributes
Hide child attributes
Type d’élément de contenu.
text, image_url, video_url, audio_url Contenu textuel, utilisé uniquement lorsque type=text.
URL de l’image, écriture objet recommandée : {"url":"https://..."}.
URL de la vidéo, syntaxe objet recommandée : {"url":"https://..."}.
URL audio, format objet recommandé : {"url":"https://..."}.
Identifiant de l’usage du média, avec des valeurs courantes telles que reference_image, reference_video, reference_audio.
Nom du contenu, utilisable dans des prompts textuels pour référence ou pour distinguer plusieurs contenus.
Facultatif. Mode de fonctionnalités avancées, tel que omni_reference pour une référence complète.
Optionnel. Champs en mode de compatibilité, tels que t2v, i2v, i2v_first_last, reference_images, reference_material ; gemini-omni prend en charge t2v, r2v et edit.
Facultatif. URL d'une seule image de référence.
Facultatif. Liste d'URL pour plusieurs images de référence.
Optionnel. Compatible avec le champ de saisie de référence.
Facultatif. URL de l'image de référence de la dernière image.
Facultatif. Alias de l'URL de l'image de référence de la dernière image.
Facultatif. Liste d'URL de vidéos de référence.
Facultatif. Liste d'URL de référence audio.
Facultatif. Durée de la vidéo, en secondes ; compatible avec duration.
Facultatif. Durée de la vidéo, en secondes ; compatible avec seconds.
Facultatif. Format d'image, tel que 16:9.
Facultatif. Alias du format d'image, tel que 16:9.
Facultatif. Champ de compatibilité pour la résolution ou les dimensions.
Facultatif. Configuration de la qualité de génération.
Facultatif. Résolution de sortie.
Facultatif. Fréquence d'images.
Facultatif. Indique si l'audio doit être généré.
Facultatif. Indique s'il faut ajouter un filigrane.
