Crear un recurso de imagen

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 una imagen a un grupo existente. Después del procesamiento, haga referencia a él como asset://<ID> en una solicitud de Seedance admitida.

Campo	Tipo	Requerido	Descripción	Ejemplo
GroupId	string	Sí	ID del grupo de activos objetivo.	group-20260320141746-zsf6b
AssetType	Image	Sí	Debe ser Image.	Image
URL	string	Sí	URL pública, URI de datos o Base64 sin formato. Las imágenes deben tener un tamaño inferior a 30 MB, entre 300 y 6000 px en cada lado y tener una relación de aspecto de 0,4 a 2,5.	https://example.com/image.jpg
file	binary	No	Alternativa multiparte a URL. Se aceptan JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF.	image.jpg
Name	string	No	Nombre para mostrar/buscar, hasta 64 caracteres. No se envía al modelo.	character-reference
model	string	No		volc-asset
ProjectName	string	No	Nombre del proyecto. Debe coincidir con el grupo objetivo; El valor predeterminado es default.	default

Ejemplo JSON:

JSON

{
  "model": "volc-asset",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}

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" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@image.jpg"

Respuesta

La imagen 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; una imagen típica tarda entre 6 y 9 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.