---
search:
  tags:
    - 素材
    - POST
seo:
  description: 使用原始JPEG、PNG或WebP字节（最多3,145,728字节），确认已准备好的mediaImport上传描述符。字节长度和SHA-256必须与描述符一致。对于文件引用或更大的本地文件，请使用…
sidebar:
  label: 确认二进制图片上传
  badge: POST
title: 确认二进制图片上传
type: openapi-operation
---
使用原始JPEG、PNG或WebP字节（最多3,145,728字节），确认已准备好的mediaImport上传描述符。字节长度和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"
}
```