mcpField
C
cos-upload

cos-upload

github.com/acedatacloudクラウド・DevOps17203 回インストール今日更新
リポジトリ

cos-upload について

cos-uploadは、ローカルファイルをAceData CDNにアップロードし、公開URLを返すスキルです。API間で素材を渡したり、中間ファイルを保持したりする用途向けに、トークンやサイズ制限、公開アクセスの注意点も示します。

主な機能

  1. 01ローカルファイルを1件アップロード
  2. 02公開CDN URLを返却
  3. 03安全な拡張子を保持
  4. 04MIMEタイプのメタデータ設定

活用シーン

  1. 01生成画像を動画APIに渡す
  2. 02完成動画やカバー画像を公開
  3. 03中間ファイルを保存して後で取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acedatacloud/skills --skill cos-upload

インストール後、Claude Code で/cos-uploadを入力して読み込まれたか確認します。

詳細

ファイルをアップロード → AceData CDN URL

ローカルファイルを公開 https://cdn.acedata.cloud/... URL に変換します。

アップロード（マルチパート、同期）

curl -s -X POST https://platform.acedata.cloud/api/v1/files/ \
  -H "Authorization: Bearer $ACEDATACLOUD_PLATFORM_TOKEN" \
  -F "file=@/path/to/video.mp4"

HTTP 200 が返されたら、URLを自分で組み立てず、返された file_url を使用します。プラットフォームは一意の uploads/<uuid> パスを生成し、アップロードされたファイル名の安全な拡張子を保持します。返された mime は、オブジェクトストレージのメタデータに書き込まれた MIME タイプです。1回のリクエストにつき1ファイルです（複数ファイルの場合は繰り返してください）。デフォルトの上限は1ファイルあたり100 MBです。

実際の内容に合った拡張子のファイル名を使用してください。アップロードパートの MIME タイプは指定された値のまま保存されます。省略された場合、または application/octet-stream の場合は、標準的な MIME マッピングを使用してファイル名から推定されます。拡張子の処理でも MIME の推定でも、ファイルのバイト列は変換されません。

使用する場面

  • 生成したアセットをURLで別のAPIに渡す — たとえば、gpt-image-2 の静止画をアップロードし、そのURLを seedance / kling の画像から動画への変換に渡します。
  • 完成した成果物を公開／返却する（最終動画、カバー画像）。
  • 中間成果物を保存することで、後の実行時に再ダウンロードして処理を続行できます。

注意事項

  • 認証には、サービスごとの API トークンではなく、プラットフォームトークン（ACEDATACLOUD_PLATFORM_TOKEN）を使用します。ファイルエンドポイントは api.acedata.cloud ではなく platform.acedata.cloud にあります。
  • 実行環境にアップローダーが組み込まれている場合（たとえば、ストレージ認証情報を管理するワーカーなど）は、そちらを優先してください。プラットフォームトークンを直接扱わずに済みます。
  • 返されたURLは認証なしで誰でもアクセスできます。機密データをアップロードしないでください。保持期間はプラットフォームの現行ストレージポリシーに従い、永久保存を保証するものではありません。長期アーカイブには独自のオブジェクトストレージを使用してください。

コメント

Markdown 対応