Vai al contenuto principale
Carica file locali sul CDN della piattaforma AceDataCloud per ottenere un URL accessibile pubblicamente (nel formato 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:
Metodo di ottenimento: accedi alla piattaforma AceDataCloud → console Account Token → fai clic sul pulsante «Crea». Per i dettagli, consulta Gestire i token dell’account della piattaforma AceDataCloud.

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)

Usa direttamente il campo 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_urls di Midjourney, image_url di Flux e reference_url di 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