Creative Files

アップロード URL を発行

最大 2 GiB のファイルを送るための URL を発行します。有効期間は 15 分です。upload_headers を付けて upload_url に PUT し、完了後に public_url を生成入力へ渡します。

POST
/v1/creative/files/generate-upload-url
curl --request POST 'https://api.orchestor.io/v1/creative/files/generate-upload-url' \  --header "Authorization: Bearer $ORCHESTOR_API_KEY" \  --header 'Content-Type: application/json' \  --data-raw '{"content_type": "image/png", "size_bytes": 482113}'
{  "data": {    "public_url": "https://media.orchestor.io/assets/asset_6f1d0c2b9a8e4f7d/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_6f1d0c2b9a8e4f7d"  }}

Authorizations

Satisfy one of these options:

  • bearerAuth
  • x-api-key

Authentication details

bearer
Authorization

外部 API キー。session は受け付けません。apiKey と同時に送ると 401 です。

Bodyapplication/jsonrequired

以下の入力を JSON で送信します。モデル固有の項目はカタログの対応条件も確認してください。

{  "content_type": "image/png",  "size_bytes": 482113}
content_typestringbodyrequired

ファイルの MIME タイプ。例は image/png、video/mp4。

size_bytesintegerbodyrequired

ファイルの正確なサイズ。単位はバイト。

Value range
≥ 1, ≤ 2147483648
filenamestringbody

元ファイルの名前。1〜255 文字。

String length
≥ 1, ≤ 255

Response

application/json

アップロードの送信先と入力用 URL。upload_headers を変更せず upload_url に PUT した後に public_url を使います。

Headers

x-orchestor-request-idstringheader

HTTP リクエストの相関 ID。ジョブの request_id とは別の値。

ratelimit-limitintegerheader

現在の期間で許可されるリクエスト数。

ratelimit-remainingintegerheader

現在の期間で残っているリクエスト数。

ratelimit-resetintegerheader

制限がリセットされるまでの秒数。

retry-afterintegerheader

再試行までの待機秒数。

{  "data": {    "public_url": "https://media.orchestor.io/assets/asset_6f1d0c2b9a8e4f7d/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_6f1d0c2b9a8e4f7d"  }}
dataobjectrequired

この操作が返す結果。形状は以下の子フィールドを参照してください。

data.public_urlstringrequired

アップロード完了後に入力へ渡すファイルの HTTPS URL。

data.upload_urlstringrequired

ファイルのバイト列を送信する署名付き URL。秘密値として扱い、API キーを送らないでください。

data.upload_methodstringenum<string>required

署名付き URL への送信に使う HTTP メソッド。PUT を使用します。

Allowed
PUT
data.upload_headersobjectrequired

ファイル送信時にそのまま付けるヘッダー。MIME タイプとサイズを変更しないでください。

data.upload_headers.*string
data.content_typestringrequired

ファイルの MIME タイプ。例は image/png、video/mp4。

data.expires_atstringrequired

署名付きアップロード URL が失効する日時。発行から 15 分以内に送信してください。

data.asset_idstringrequired

アップロードしたファイルを識別する ID。