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/.
Обзор интерфейса
Описание аутентификации (как получить токен аккаунта)
Заголовок запроса:Тело запроса (multipart/form-data)
Платформа самостоятельно генерирует уникальный путь к файлу и сохраняет безопасное расширение из имени загружаемого файла, например,
photo.jpg соответствует uploads/<uuid>.jpg. MIME-тип, предоставленный частью загрузки, записывается в метаданные файла; если он не предоставлен или равен application/octet-stream, платформа определяет тип по имени файла и стандартному сопоставлению MIME. Расширение и определение MIME не преобразуют содержимое файла, убедитесь, что имя файла соответствует фактическому формату.
Примеры запросов
cURL
Python
Node.js
Пример ответа (HTTP 200, фрагмент)
file_url в других бизнес-интерфейсах — URL CDN в настоящее время доступен публично и не требует аутентификации; не считайте его гарантией постоянного хранения.
Описание полей ответа
Обработка ошибок
Практические советы
- Загрузка изображений для референса: Midjourney
image_urls, Fluximage_urlи Veoreference_urlпринимают URL CDN, не принимают base64. Сначала получить URL через этот интерфейс — обычная практика. - Не загружайте конфиденциальные данные: возвращённый URL общедоступен; срок хранения определяется текущей политикой хранения платформы, для долгосрочного архивирования используйте собственное объектное хранилище.
- Массовая загрузка: контролируйте параллелизм и устанавливайте тайм-аут для каждой загрузки; пропускная способность зависит от размера файлов и сетевой среды.
Связанные интерфейсы
- Получение списка сервисов платформы AceDataCloud — найдите бизнес-сервисы, принимающие URL в качестве входных данных
- Создание API-учётных данных платформы AceDataCloud — после загрузки следующим шагом обычно является создание учётных данных для вызова бизнес-интерфейсов

