Carga y descarga de medios
Cargas firmadas y URL temporales para los resultados.
Puedes pasar una URL HTTPS pública de imagen, video o audio directamente al campo admitido por el modelo. La carga y el commit siguientes solo son necesarios para archivos locales. Descarga el resultado directamente desde output.assets[].url, sin enviar la clave API. expiresAt suele estar a 20 minutos y nunca supera los 14 días de conservación. Consulta de nuevo para renovar el enlace; download-url es opcional.
POST /api/v1/common/upload-url
PUT <uploadUrl>
POST /api/v1/files/{fileId}/commit
GET <output.assets[].url>Subir Base64 con el SDK
client.uploadBase64 acepta una Data URI o una cadena Base64 con contentType y ejecuta el proceso existente de subida y commit. Pasa a input la URI spicy:// que devuelve. El límite es de 10 MiB para imágenes y 100 MiB para audio y video; también se aplican los límites inferiores del modelo. Este método no envía Base64 directamente a un campo de entrada del modelo.
Cargar una entrada
POST /api/v1/common/upload-url devuelve fileId y uploadUrl. Haz el PUT con el Content-Type indicado, llama después a POST /api/v1/files/{fileId}/commit y usa únicamente la URI spicy:// devuelta en el input del modelo. No uses uploadUrl ni una ruta temporal del objeto como input.
El Content-Type debe coincidir con la firma. Valida también formato y tamaño en el cliente. Las URI pertenecen a una cuenta y no pueden usarse entre cuentas.
Descargar el resultado
Descarga el resultado directamente desde output.assets[].url, sin enviar la clave API. expiresAt suele estar a 20 minutos y nunca supera los 14 días de conservación. Consulta de nuevo para renovar el enlace; download-url es opcional.
Consulta el contrato OpenAPI 3.1 para ver la definición completa de los campos.
Documentación relacionada
El límite es de 10 MiB para imágenes y 100 MiB para audio y video. Respeta un max_size_mb inferior del esquema y el maxBytes del ticket. La duración máxima es de 600 segundos. Commit comprueba el formato real y puede devolver durationSeconds como cadena decimal, width y height. En el flujo de carga administrada, usa la referencia spicy:// devuelta por un commit correcto, válida durante un día. Este flujo no es obligatorio para una URL pública o datos Base64 admitidos por el campo.
image/jpeg · image/png · image/webp · image/gif · video/mp4 · video/webm · audio/mpeg · audio/wav