메인 콘텐츠로 건너뛰기
로컬 파일을 AceDataCloud 플랫폼 CDN에 업로드하여 공개적으로 액세스할 수 있는 URL(https://cdn.acedata.cloud/uploads/<uuid>.png 형식)을 받고, 다른 비즈니스 API 인터페이스(예: Midjourney, Suno, Flux)의 image_url, reference_url 등의 파라미터에서 즉시 참조할 수 있습니다. 적용 시나리오:
  • Midjourney /midjourney/imagine 호출 전에 배경 이미지를 먼저 CDN에 업로드하여 URL을 받습니다.
  • 이전 단계에서 생성한 비디오를 캐시하여 다음 단계의 입력으로 사용합니다.
  • 사용자가 업로드한 소재를 임시 호스팅하여 자체 S3 구축을 피합니다.
ℹ️ 이 인터페이스는 AceDataCloud 플랫폼 관리 API에 속하며, 통합 접두사는 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 필드를 다른 비즈니스 인터페이스에서 직접 사용하면 됩니다——CDN URL은 현재 공개적으로 액세스 가능하며 인증이 필요하지 않습니다. 이를 영구 보관 약속으로 간주하지 마세요.

응답 필드 설명

오류 처리

유용한 팁

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

관련 인터페이스