メインコンテンツへスキップ
ローカルファイルを AceDataCloud プラットフォーム CDN にアップロードし、公開アクセス可能な URL(https://cdn.acedata.cloud/uploads/<uuid>.png 形式)を取得します。取得した URL は、他のビジネス 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 フィールドをそのまま他のビジネス API で使用すればよいです——CDN URL は現在公開アクセス可能であり、認証は不要です。これを永続的なアーカイブの保証と見なさないでください。

レスポンスフィールドの説明

エラー処理

実用的なヒント

  • 画像を下絵としてアップロードする:Midjourney の image_urls、Flux の image_url、Veo の reference_url はすべて CDN URL を受け付け、base64 は受け付けません。まず本インターフェースで URL を取得するのが通常の操作です。
  • 機密データをアップロードしない:返される URL は公開アクセス可能です。保存期間はプラットフォームの現在のストレージポリシーに従います。長期アーカイブには自身のオブジェクトストレージを使用してください。
  • 大量アップロード:並行処理を制御し、各アップロードにタイムアウトを設定してください。スループットはファイルサイズとネットワーク環境に依存します。

関連インターフェース