---
title: "列出知识库图片资产（body 版）"
method: POST
path: "/knowledge-bases/{id}/images"
tags: ["knowledge"]
---

# 列出知识库图片资产（body 版）

`POST /knowledge-bases/{id}/images`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/knowledge-bases/{id}/images`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

与 GET /images 同义，筛选参数改经 JSON body 传递：knowledge_ids 不再受 URL 长度限制（上限 1000），供来源文档全选使用。

## Path parameters

- `id` string, required

## Request body

- InternalHandlerImageListRequestBody
  - `attr_filters` object
  - `attr_rules` object
  - `is_enabled` boolean
  - `keyword` string
  - `knowledge_ids` string[]
  - `page` integer: Page
  - `page_size` integer: Page size
  - `search_in` string[]
  - `sort_by` string
  - `sort_order` string

## Response `200`

图片资产分页列表

- object
  - `data` GithubComTencentWeKnoraInternalTypesImageAsset[]
    - `attrs` object: Attrs is the observed attribute map (e.g. contain.text, contain.data_visual) produced by the attribute pipeline. Absent keys mean "not observed".
    - `caption` string: Caption is the model-generated image description.
    - `chunk_id` string: ChunkID is the owning chunk (text chunk for embedded images, or the image_ocr / image_caption chunk for dedicated image assets).
    - `chunk_type` string: ChunkType is the owning chunk's type; empty for images discovered on a text (document) chunk. Helps the UI label the source.
    - `created_at` string: CreatedAt is the owning chunk's creation time.
    - `id` string: ID is stable and unique within a KB: "<chunkID>#<index-in-array>".
    - `is_enabled` boolean: IsEnabled mirrors the owning chunk's enabled flag.
    - `knowledge_id` string: KnowledgeID is the document/knowledge item the image belongs to.
    - `ocr_text` string: OCRText is the extracted text from the image, if any.
    - `original_url` string: OriginalURL is the pre-transform source reference, when different.
    - `source_name` string: SourceName is the human-readable name of the source knowledge item (document), resolved from KnowledgeID. Empty when the item no longer exists (e.g. deleted), in which case KnowledgeID is still shown.
    - `status` integer: Status mirrors the owning chunk's index status.
    - `updated_at` string: UpdatedAt is the owning chunk's last update time.
    - `url` string: URL is the rendered image URL (COS / storage provider).
  - `page` integer
  - `page_size` integer
  - `success` boolean
  - `total` integer

## Other responses

- `400`: 请求参数错误

## Changes

- **2026-10-14** `a1c41ab134cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/knowledge-bases/:id/images/post.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/weknora-api/revisions/685d1f9fce30?raw)