Create Media asynchronously

Requires the media create permission. Creates Media asynchronously from staged uploads or external public image URLs. client_reference_id must be unique within this request, contain 1-128 letters, digits, underscores, or hyphens, and is correlation data rather than an idempotency key. A valid batch returns HTTP 200 for full success, partial success, or when every item has an item-level error.
需要圖像建立權限。系統會從暫存上傳或外部公開圖片網址非同步建立圖像。client_reference_id 在同一請求中必須唯一,長度為 1-128 個字元,且只能包含英文字母、數字、底線或連字號;此欄位 僅供關聯結果,並非冪等鍵。有效的批次請求無論全部成功、部分成功,或所有項目皆發生項目層級錯誤, 均回傳 HTTP 200。

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
medias
array of objects
required
length between 1 and 20

Media sources processed independently; each reference must be unique.
獨立處理的圖像來源;每個參考值必須唯一。

medias*

An asynchronous Media request and its correlation value.
非同步圖像請求及其關聯值。

string
required
length between 1 and 128
^[A-Za-z0-9_-]+$

Caller-generated value used to match this item to its result. It must be unique within this request and is not an idempotency key.
呼叫端產生的值,用於將此項目與結果配對。 此值在同一請求中必須唯一,且並非冪等鍵。

source
required

One staged-upload or external-URL image source.
一個暫存上傳或外部網址圖像來源。

Responses

400

INVALID_REQUEST, INVALID_CLIENT_REFERENCE, or DUPLICATE_CLIENT_REFERENCE
請求或參考 ID 無效

413

BATCH_SIZE_EXCEEDED
超出批次大小限制

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json