Crear un recurso de vídeo

Disponibilidad

Esta página documenta la ruta de gestión de activos de Modelflare. Las llamadas requieren una clave API inteligente válida o una clave API de grupo de medios, un canal de medios disponible y el permiso requerido.

Nota

La puerta de enlace registra los ID de los activos del proveedor, el estado y la propiedad del usuario. La biblioteca local de Castaly permanece separada del espacio de nombres de activos del proveedor.

Punto final

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

Autenticación

Utilice una clave API de Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Enviar Idempotency-Key con solicitudes de creación, actualización y eliminación. Al volver a intentar la misma clave para el mismo usuario, se reproduce la respuesta guardada sin repetir la mutación.

Solicitud

Agregar un video a un grupo existente. El ID devuelto puede ser utilizado por los flujos de trabajo de Seedance compatibles después del procesamiento.

Campo	Tipo	Requerido	Descripción	Ejemplo
GroupId	string	Sí	ID del grupo de activos objetivo.	group-20260320141746-zsf6b
AssetType	Video	Sí	Debe ser Video.	Video
URL	string	Sí	URL del vídeo público. No se acepta vídeo Base64. Utilice MP4 o MOV, de 2 a 30 segundos, de 24 a 60 FPS, de 300 a 6000 px en cada lado, de 0,4 a 2,5 de relación de aspecto, de 480p/720p/1080p/4K, de 407696 a 2086876 píxeles en total y no más de 200 MB.	https://example.com/video.mp4
file	binary	No	Alternativa multiparte a URL con las mismas restricciones de video.	video.mp4
Name	string	No	Nombre para mostrar/buscar, hasta 64 caracteres.	scene-clip
model	string	Sí		volc-asset-video
ProjectName	string	No	Nombre del proyecto. Debe coincidir con el grupo objetivo; El valor predeterminado es default.	default

Ejemplo JSON:

JSON

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

ejemplo de datos de formulario/multiparte:

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"

Respuesta

El vídeo ha entrado en procesamiento asincrónico. Sondee GetAsset hasta que Status sea Active o Failed. No hay ningún acuerdo de nivel de servicio (SLA) en el momento de la carga; un vídeo típico dura entre 9 y 12 segundos, mientras que una cola de revisión ocupada puede tardar entre 10 segundos y 2 minutos.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID de activo. Utilice asset://<ID> sólo después de que el estado sea Active.	asset-20260528140922-d9646

Ejemplo de respuesta:

JSON

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

Errores

Estado	Significado
400	La solicitud no es válida.
401	Falta la clave API o no está autorizada.

Ejemplo del cuerpo del error (cuando se devuelve):

JSON

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

La creación de imágenes, videos y audio es asíncrona. Después de recibir una ID de activo, llame a GetAsset y use la referencia asset://<ID> solo cuando el estado sea Active.