**版本：202601**

# 创建商品图片

**POST** `/openapi/2026-01/products/:product_id/images`

使用提供的详情创建新的商品图片。

## 请求

**Path参数**

- `product_id` string (required)

  商品 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `image` object (required)

  图片

  - `src` string (required)

    图片的 URL，必须为有效 URL
  - `alt` string

    图片的替代文本（用于可访问性或描述）
  - `width` int32

    图片宽度（像素），必须大于 0
  - `height` int32

    图片高度（像素），必须大于 0
  - `position` int32

    图片相对于其他图片的位置，必须大于 0

```json
{
  "image": {
    "src": "string",
    "alt": "string",
    "width": 0,
    "height": 0,
    "position": 0
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `image` object

    图片

    - `id` string

      图片 ID
    - `product_id` string

      与图片关联的商品 ID
    - `position` int32

      图片在商品图库中相对于其他图片的位置
    - `src` string

      图片的 URL
    - `width` int32

      图片宽度（像素）
    - `height` int32

      图片高度（像素）
    - `alt` string

      图片的替代文本（用于可访问性或描述）
    - `created_at` string

      图片创建时间
    - `updated_at` string

      图片最后更新时间

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "image": {
      "id": "string",
      "product_id": "string",
      "position": 0,
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```