Créer un élément vidéo

Disponibilité

Cette page documente l’itinéraire de gestion des actifs de Modelflare. Les appels nécessitent une clé API intelligente ou une clé API de groupe multimédia valide, un canal multimédia disponible et l’autorisation requise.

Note

La passerelle enregistre les ID d’actif du fournisseur, le statut et la propriété de l’utilisateur. La bibliothèque locale Castaly reste distincte de l’espace de noms des actifs du fournisseur.

Point de terminaison

POST https://modelflare.dev/volc/asset/CreateAsset

Authentification

Utilisez une clé API Modelflare :

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Envoyez Idempotency-Key avec les demandes de création, de mise à jour et de suppression. Réessayer la même clé pour le même utilisateur rejoue la réponse enregistrée sans répéter la mutation.

Demande

Ajouter une vidéo à un groupe existant. L’ID renvoyé peut être utilisé par les flux de travail Seedance pris en charge après le traitement.

Champ	Type	Obligatoire	Descriptif	Exemple
GroupId	string	Oui	ID du groupe d’actifs cible.	group-20260320141746-zsf6b
AssetType	Video	Oui	Doit être Video.	Video
URL	string	Oui	URL de la vidéo publique. La vidéo Base64 n’est pas acceptée. Utilisez MP4 ou MOV, 2 à 30 secondes, 24 à 60 FPS, 300 à 6 000 px de chaque côté, rapport hauteur/largeur de 0,4 à 2,5, 480p/720p/1080p/4K, 407 696 à 2086 876 pixels au total et pas plus de 200 Mo.	https://example.com/video.mp4
file	binary	Non	Alternative multipart à URL avec les mêmes contraintes vidéo.	video.mp4
Name	string	Non	Nom d’affichage/de recherche, jusqu’à 64 caractères.	scene-clip
model	string	Oui		volc-asset-video
ProjectName	string	Non	Nom du projet. Il doit correspondre au groupe cible ; la valeur par défaut est default.	default

Exemple JSON :

JSON

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

Exemple de données multipart/formulaire :

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

Réponse

La vidéo est entrée en traitement asynchrone. Interrogez GetAsset jusqu’à ce que Status soit Active ou Failed. Il n’y a pas de SLA de temps de téléchargement ; une vidéo typique prend environ 9 à 12 secondes, tandis qu’une file d’attente de révision chargée peut prendre environ 10 secondes à 2 minutes.

Champ	Type	Obligatoire	Descriptif	Exemple
Id	string	Oui	ID d’actif. Utilisez asset://<ID> uniquement lorsque l’état est Active.	asset-20260528140922-d9646

Exemple de réponse :

JSON

{
  "Id": "asset-20260528140922-d9646"
}

Erreurs

Statut	Signification
400	La demande n’est pas valide.
401	La clé API est manquante ou non autorisée.

Exemple de corps d’erreur (une fois renvoyé) :

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

La création d’images, de vidéos et d’audio est asynchrone. Après avoir reçu un ID d’actif, appelez GetAsset et utilisez la référence asset://<ID> uniquement lorsque l’état est Active.