Загрузка файлов на 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 — после загрузки обычно следующим шагом является создание учётных данных для вызова бизнес-интерфейсов