基本概念

ファイルのアップロード

入力素材が公開 HTTPS URL にない場合は、アップロード用 URL を発行して画像・動画・音声を送信します。

1. アップロード用 URL を取得する

content_type と正確なバイト数を送信します。ファイルサイズの上限は 2 GiB です。

SIZE_BYTES=$(wc -c < ./input.png | tr -d ' ')
UPLOAD=$(curl --silent --show-error --fail-with-body \
  --request POST https://api.orchestor.io/v1/creative/files/generate-upload-url \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{\"content_type\":\"image/png\",\"size_bytes\":$SIZE_BYTES,\"filename\":\"input.png\"}")
printf '%s' "$UPLOAD" | jq

応答例です。URL、ヘッダー、有効期限には実際の応答値を使います。

{
  "data": {
    "public_url": "https://media.orchestor.io/assets/asset_example/source.png",
    "upload_url": "https://storage.example.com/upload/example?signature=EXAMPLE_ONLY",
    "upload_method": "PUT",
    "upload_headers": { "content-type": "image/png", "content-length": "482113" },
    "content_type": "image/png",
    "expires_at": "2026-11-06T00:15:00Z",
    "asset_id": "asset_example"
  }
}

アップロード用 URL の有効期間は発行から 15 分です。

2. ファイルをアップロードする

upload_url にファイルのバイト列を送り、upload_headers のすべてのヘッダーを付けます。JSON やフォームには変換しません。

UPLOAD_HEADERS=$(mktemp)
printf '%s' "$UPLOAD" | jq -r '.data.upload_headers | to_entries[] | "\(.key): \(.value)"' > "$UPLOAD_HEADERS"
if ! curl --fail-with-body \
  --request "$(printf '%s' "$UPLOAD" | jq -r '.data.upload_method')" \
  --url "$(printf '%s' "$UPLOAD" | jq -r '.data.upload_url')" \
  --header "@$UPLOAD_HEADERS" \
  --upload-file ./input.png; then
  rm -f "$UPLOAD_HEADERS"
  exit 1
fi
rm -f "$UPLOAD_HEADERS"

ストレージへの送信には Orchestor の API キーを付けないでください。署名付き URL は秘密値として扱います。

3. 公開 URL を使用する

アップロードが成功してから public_url を生成入力の image_urls、video_url、audio_url などに渡します。入力フィールドはモデルごとに確認してください。

INPUT_URL=$(printf '%s' "$UPLOAD" | jq -r '.data.public_url')

コンテンツタイプ

素材の種類に合う MIME タイプを指定します。

  • 画像:image/png、image/jpeg
  • 動画:video/mp4
  • 音声:audio/wav

URL 発行時とアップロード時の MIME タイプ・バイト数を一致させます。解像度、長さ、参照数はモデル一覧の入力仕様にも従います。

関連ページ