ファイル

アップロード 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"  }}

認証

次のいずれかの条件を満たしてください。

  • bearerAuth
  • x-api-key

認証の詳細

bearer
Authorization

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

ボディapplication/json必須

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

{  "content_type": "image/png",  "size_bytes": 482113}
content_typestringbody必須

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

size_bytesintegerbody必須

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

値の範囲
≥ 1, ≤ 2147483648
filenamestringbody

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

文字数
≥ 1, ≤ 255

レスポンス

application/json

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

ヘッダー

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"  }}
dataobject必須

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

data.public_urlstring必須

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

data.upload_urlstring必須

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

data.upload_methodstringenum<string>必須

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

許可される値
PUT
data.upload_headersobject必須

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

data.upload_headers.*string
data.content_typestring必須

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

data.expires_atstring必須

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

data.asset_idstring必須

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