Завантаження файлів на CDN платформи AceDataCloud

• Перед викликом Midjourney /midjourney/imagine спочатку завантажте референсне зображення на CDN, щоб отримати URL.
• Кешуйте відео, згенероване на попередньому кроці, щоб використати його як вхідні дані для наступного кроку.
• Тимчасово розміщуйте матеріали, завантажені користувачами, щоб уникнути самостійного налаштування S3.

ℹ️ Цей інтерфейс належить до API керування платформою AceDataCloud, з єдиним префіксом https://platform.acedata.cloud/api/v1/.

​

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

​

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

Authorization: Bearer ${PLATFORM_TOKEN}

​

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

​

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

​

cURL

curl -X POST 'https://platform.acedata.cloud/api/v1/files/' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}" \
  -F 'file=@./photo.jpg'

​

Python

import os
import requests

PLATFORM_TOKEN = os.environ["PLATFORM_TOKEN"]

with open("photo.jpg", "rb") as f:
    resp = requests.post(
        "https://platform.acedata.cloud/api/v1/files/",
        headers={
            "accept": "application/json",
            "authorization": f"Bearer {PLATFORM_TOKEN}",
        },
        files={"file": ("photo.jpg", f, "image/jpeg")},
        timeout=60,
    )

data = resp.json()
print(f"✅ 上传成功：{data['file_url']}")
# 直接用于其他业务接口：
# requests.post("https://api.acedata.cloud/midjourney/imagine",
#     json={"prompt": "...", "image_urls": [data["file_url"]]}, ...)

​

Node.js

const fs = require('fs')
const FormData = require('form-data')

const form = new FormData()
form.append('file', fs.createReadStream('./photo.jpg'))

const r = await fetch('https://platform.acedata.cloud/api/v1/files/', {
  method: 'POST',
  headers: {
    authorization: `Bearer ${process.env.PLATFORM_TOKEN}`,
    ...form.getHeaders(),
  },
  body: form,
})
const data = await r.json()
console.log('CDN URL:', data.file_url)

​

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

{
  "file_url": "https://cdn.acedata.cloud/qrd7gw.jpg"
}

​

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

​

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

​

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

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

​

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

• Отримання списку сервісів платформи AceDataCloud — знайдіть бізнес-сервіси, які приймають URL як вхідні дані
• Створення API-облікових даних платформи AceDataCloud — після завантаження зазвичай наступним кроком є створення облікових даних для виклику бізнес-інтерфейсів