---
title: ファイルのアップロード
description: ローカルの画像や動画をアップロードし、生成の入力 URL として使います。
canonical_url: https://orchestor.io/docs/creative/uploads
markdown_url: https://orchestor.io/docs/creative/uploads.md
contentType: guide
---

# ファイルのアップロード

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

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

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

```bash
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、ヘッダー、有効期限には実際の応答値を使います。

```json
{
  "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 やフォームには変換しません。

```bash
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` などに渡します。入力フィールドはモデルごとに確認してください。

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

## コンテンツタイプ

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

- 画像：`image/png`、`image/jpeg`
- 動画：`video/mp4`
- 音声：`audio/wav`

URL 発行時とアップロード時の MIME タイプ・バイト数を一致させます。解像度、長さ、参照数は[モデル一覧](https://orchestor.io/docs/creative/models.md)の入力仕様にも従います。

## 関連ページ

- [料金とデータ保持](https://orchestor.io/docs/creative/concepts/billing-and-retention.md)
- [クライアントライブラリ](https://orchestor.io/docs/creative/client.md)
- [Creative API](https://orchestor.io/docs/creative.md)
- [よくある質問](https://orchestor.io/docs/creative/help/faq.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
