Перейти до основного вмісту
Завантажте локальні файли до CDN платформи AceDataCloud, щоб отримати загальнодоступний URL (у стилі https://cdn.acedata.cloud/uploads/<uuid>.png), який можна негайно використовувати в параметрах image_url, reference_url та інших параметрах інших бізнес-інтерфейсів (таких як Midjourney, Suno, Flux). Застосовні сценарії:
  • Перед викликом Midjourney /midjourney/imagine спочатку завантажте референсне зображення до CDN, щоб отримати URL.
  • Кешуйте відео, згенероване на попередньому кроці, для використання як вхідних даних на наступному кроці.
  • Тимчасово розміщуйте матеріали, завантажені користувачами, щоб уникнути самостійного розгортання S3.
ℹ️ Цей інтерфейс належить до API керування платформою AceDataCloud, з єдиним префіксом https://platform.acedata.cloud/api/v1/.

Огляд інтерфейсу

Пояснення щодо автентифікації (як отримати токен облікового запису)

Заголовок запиту:
Спосіб отримання: увійдіть до платформи AceDataCloud → консолі Account Token → натисніть кнопку «Створити». Докладніше дивіться в Керування токенами облікового запису платформи AceDataCloud.

Тіло запиту(multipart/form-data)

Платформа самостійно генерує унікальний шлях до файлу та зберігає безпечне розширення з імені завантаженого файлу, наприклад, photo.jpg відповідає uploads/<uuid>.jpg. MIME-тип, наданий частиною завантаження, буде записано до метаданих файлу; якщо його не надано або це application/octet-stream, платформа використовує ім’я файлу та стандартне MIME-відображення для визначення типу. Розширення та визначення MIME не перетворюють вміст файлу, переконайтеся, що ім’я файлу відповідає фактичному формату.

Приклади запитів

cURL

Python

Node.js

Приклад відповіді(HTTP 200, уривок)

Просто використовуйте поле file_url в інших бізнес-інтерфейсах — CDN URL наразі загальнодоступний і не потребує автентифікації; не вважайте його гарантією постійного зберігання.

Опис полів відповіді

Обробка помилок

Практичні поради

  • Завантаження зображень як референсів:Midjourney image_urls, Flux image_url, Veo reference_url усі приймають CDN URL, не приймають base64. Спочатку отримати URL через цей інтерфейс — звичайна практика.
  • Не завантажуйте конфіденційні дані:повернений URL є загальнодоступним; термін зберігання визначається поточною політикою зберігання платформи, для довгострокового архівування використовуйте власне об’єктне сховище.
  • Масове завантаження:контролюйте паралельність і встановлюйте тайм-аут для кожного завантаження; пропускна здатність залежить від розміру файлу та мережевого середовища.

Пов’язані інтерфейси