Saltar al contenido principal
Sube archivos locales a la CDN de la plataforma AceDataCloud para obtener una URL de acceso público (con el estilo https://cdn.acedata.cloud/uploads/<uuid>.png), que puede citarse inmediatamente en parámetros como image_url, reference_url de otras interfaces de negocio (como Midjourney, Suno, Flux). Escenarios aplicables:
  • Antes de llamar a Midjourney /midjourney/imagine, primero sube la imagen de referencia a la CDN para obtener una URL.
  • Almacena en caché el video generado en el paso anterior para usarlo como entrada del siguiente paso.
  • Aloja temporalmente los recursos subidos por los usuarios, evitando construir tu propio S3.
ℹ️ Esta interfaz pertenece a la API de administración de la plataforma AceDataCloud, con el prefijo unificado https://platform.acedata.cloud/api/v1/.

Resumen de la interfaz

Descripción de autenticación (cómo obtener el token de cuenta)

Encabezado de solicitud:
Método de obtención: inicia sesión en la plataforma AceDataCloud → consola de Account Token → haz clic en el botón «Crear». Consulta los detalles en Administrar tokens de cuenta de la plataforma AceDataCloud.

Cuerpo de la solicitud(multipart/form-data)

La plataforma genera por sí misma una ruta de archivo única y conserva las extensiones seguras del nombre del archivo subido; por ejemplo, photo.jpg corresponde a uploads/<uuid>.jpg. El tipo MIME proporcionado por la parte de carga se escribe en los metadatos del archivo; cuando no se proporciona o es application/octet-stream, la plataforma infiere el tipo mediante el nombre del archivo y el mapeo MIME estándar. La extensión y la inferencia MIME no convierten el contenido del archivo; asegúrate de que el nombre del archivo coincida con el formato real.

Ejemplos de solicitud

cURL

Python

Node.js

Ejemplo de respuesta(HTTP 200, extracto)

Simplemente usa el campo file_url directamente en otras interfaces de negocio; la URL de la CDN actualmente es de acceso público y no requiere autenticación; no la consideres una promesa de archivado permanente.

Descripción de los campos de respuesta

Manejo de errores

Consejos prácticos

  • Subir imágenes como imágenes de referencia: image_urls de Midjourney, image_url de Flux y reference_url de Veo aceptan URL de CDN, no aceptan base64. Primero obtener una URL con esta interfaz es una operación habitual.
  • No subas datos sensibles: la URL devuelta es públicamente accesible; el período de conservación se rige por la política de almacenamiento actual de la plataforma; para archivado a largo plazo, utiliza tu propio almacenamiento de objetos.
  • Carga masiva: controla la concurrencia y establece un tiempo de espera para cada carga; el rendimiento depende del tamaño del archivo y del entorno de red.

Interfaces relacionadas