Перейти к основному содержанию
Загрузите локальные файлы на 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 в других бизнес-интерфейсах — URL CDN в настоящее время доступен публично и не требует аутентификации; не считайте его гарантией постоянного хранения.

Описание полей ответа

Обработка ошибок

Практические советы

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

Связанные интерфейсы