Skip to main content
로컬 파일을 AceDataCloud 플랫폼 CDN에 업로드하여 공개적으로 접근 가능한 URL(https://cdn.acedata.cloud/xxxxxx.png 형식)을 얻고, 다른 비즈니스 API(예: Midjourney, Suno, Flux)의 image_url, reference_url 등의 파라미터에서 즉시 참조할 수 있습니다. 적용 시나리오:
  • Midjourney /midjourney/imagine를 호출하기 전에 먼저 참조 이미지를 CDN에 업로드하여 URL을 가져옵니다.
  • 이전 단계에서 생성된 비디오를 캐시하여 다음 단계의 입력으로 사용합니다.
  • 사용자가 업로드한 소스를 임시 호스팅하여 자체 S3 구축을 피합니다.
ℹ️ 이 API는 AceDataCloud 플랫폼 관리 API에 속하며, 통합 접두사는 https://platform.acedata.cloud/api/v1/입니다.

API 개요

인증 설명(계정 토큰을 얻는 방법)

요청 헤더:
획득 방법: AceDataCloud 플랫폼에 로그인 → Account Token 콘솔 → 「생성」 버튼 클릭. 자세한 내용은 AceDataCloud 플랫폼 계정 토큰 관리를 참조하세요.

요청 본문(multipart/form-data)

요청 예시

cURL

Python

Node.js

응답 예시(HTTP 200)

file_url 필드를 다른 비즈니스 API에 그대로 사용하면 됩니다——현재 CDN URL은 공개적으로 접근할 수 있으며 인증이 필요하지 않습니다. 이를 영구 보관 약속으로 간주하지 마세요.

응답 필드 설명

오류 처리

유용한 팁

  • 참조 이미지 업로드: Midjourney image_urls, Flux image_url, Veo reference_url은 모두 CDN URL을 허용하며, base64는 허용하지 않습니다. 먼저 이 API로 URL을 얻는 것이 일반적인 작업입니다.
  • 민감한 데이터를 업로드하지 마세요: 반환된 URL은 공개적으로 접근할 수 있습니다. 보관 기간은 플랫폼의 현재 저장 정책을 따르며, 장기 보관에는 자체 객체 스토리지를 사용하세요.
  • 대량 업로드: 동시성을 제어하고 각 업로드에 대해 타임아웃을 설정하세요. 처리량은 파일 크기와 네트워크 환경에 따라 달라집니다.

관련 API