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/ です。
インターフェース概要
認証の説明(アカウントトークンの取得方法)
リクエストヘッダー:リクエストボディ(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 は公開アクセス可能です。保存期間はプラットフォームの現在のストレージポリシーに従います。長期アーカイブには自身のオブジェクトストレージを使用してください。
- 大量アップロード:並行処理を制御し、各アップロードにタイムアウトを設定してください。スループットはファイルサイズとネットワーク環境に依存します。
関連インターフェース
- AceDataCloud プラットフォームサービス一覧を取得する — URL 入力を受け付けるビジネスサービスを見つける
- AceDataCloud プラットフォーム API 認証情報を作成する — アップロード後、通常は次のステップとして認証情報を作成しビジネス API を呼び出す

