---
search:
  tags:
    - 媒體
    - POST
seo:
  description: >-
    以原始 JPEG、PNG 或 WebP 位元組，確認已準備的 mediaImport 上傳描述物件（最多 3,145,728 位元組）。位元組長度與
    SHA-256…
sidebar:
  label: 確認二進位圖片上傳
  badge: POST
title: 確認二進位圖片上傳
type: openapi-operation
---
以原始 JPEG、PNG 或 WebP 位元組，確認已準備的 mediaImport 上傳描述物件（最多 3,145,728 位元組）。位元組長度與 SHA-256 必須符合描述物件。檔案參照或較大的本機檔案，請使用文件所述媒體工具與 SDK 分段傳輸流程。

`POST /api/v1/media/import`

**請求主體** (`application/octet-stream`, 必要)

請求主體範例:

```json
"string"
```

**回應**

- `200` — 媒體結果；請檢查 ok 與素材狀態。
- `400` — 請求無效。不接受查詢參數。工具驗證失敗可能使用工具錯誤封裝格式。
- `401` — 未提供 bearer 憑證，或憑證無效、已到期。
- `403` — 憑證缺少必要權限。
- `404` — 供程式呼叫的 API 或要求的工具無法使用。
- `413` — 請求超過位元組上限。
- `429` — 已超過速率限制。此錯誤可重試。
- `503` — API 或其上游執行環節無法使用。

回應範例, 200:

```json
{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}
```