https://cdn.acedata.cloud/uploads/<uuid>.png), che può essere immediatamente referenziato in parametri come image_url, reference_url e altri parametri nelle interfacce API di altri servizi (come Midjourney, Suno, Flux).
Scenari applicabili:
- Carica prima l’immagine di riferimento sul CDN per ottenere un URL prima di chiamare Midjourney
/midjourney/imagine. - Memorizza nella cache il video generato nel passaggio precedente per usarlo come input del passaggio successivo.
- Ospita temporaneamente i materiali caricati dagli utenti, evitando di creare un proprio S3.
ℹ️ Questa interfaccia API appartiene alla API di gestione della piattaforma AceDataCloud, con prefisso unificato https://platform.acedata.cloud/api/v1/.
Panoramica dell’interfaccia
Istruzioni per l’autenticazione (come ottenere il token dell’account)
Intestazione della richiesta:Corpo della richiesta (multipart/form-data)
La piattaforma genera autonomamente un percorso file univoco e conserva le estensioni sicure nel nome del file caricato; ad esempio,
photo.jpg corrisponde a uploads/<uuid>.jpg. Il tipo MIME fornito dalla parte caricata viene scritto nei metadati del file; se non viene fornito o è application/octet-stream, la piattaforma deduce il tipo in base al nome del file e alle mappature MIME standard. L’estensione e la deduzione MIME non convertono il contenuto del file; assicurati che il nome del file corrisponda al formato effettivo.
Esempi di richiesta
cURL
Python
Node.js
Esempio di risposta (HTTP 200, estratto)
file_url nelle altre interfacce API di servizio: l’URL CDN è attualmente accessibile pubblicamente e non richiede autenticazione; non considerarlo una garanzia di archiviazione permanente.
Descrizione dei campi della risposta
Gestione degli errori
Suggerimenti pratici
- Caricare immagini come immagini di riferimento:
image_urlsdi Midjourney,image_urldi Flux ereference_urldi Veo accettano tutti URL CDN, non accettano base64. Ottenere prima un URL tramite questa interfaccia API è un’operazione comune. - Non caricare dati sensibili: l’URL restituito è accessibile pubblicamente; il periodo di conservazione dipende dalla politica di archiviazione corrente della piattaforma. Per l’archiviazione a lungo termine, utilizza il tuo object storage.
- Caricamenti in grandi quantità: controlla la concorrenza e imposta un timeout per ogni caricamento; il throughput dipende dalle dimensioni del file e dall’ambiente di rete.
Interfacce API correlate
- Ottenere l’elenco dei servizi della piattaforma AceDataCloud — trova i servizi aziendali che accettano input URL
- Creare credenziali API della piattaforma AceDataCloud — dopo il caricamento, il passaggio successivo è generalmente creare credenziali per chiamare le interfacce API di servizio

