---
title: "上传URL文档"
method: POST
path: "/llm-application/open/document/upload_url"
tags: ["知识库 API"]
---

# 上传URL文档

`POST /llm-application/open/document/upload_url`

上传`URL`类型的文档或网页作为内容填充知识库。点击 **Try it** 按钮可快速试用。

## Request body

- UploadUrlKnowledgeRequest
  - `upload_detail` UrlData[], required — url列表
    - `url` string, required — url
    - `knowledge_type` integer, required — 文档切片类型
    - `custom_separator` string[] — 自定义切片分隔符，仅 knowledge_type=5 时生效，默认
    - `sentence_size` integer — 自定义切片字数，仅 knowledge_type=5 时生效，20-2000，默认300
    - `callback_url` string — 回调地址
    - `callback_header` object — 回调header k-v
  - `knowledge_id` string, required — 知识库id

## Response `200`

请求成功

- UploadUrlKnowledgeResponse
  - `data` object
    - `successInfos` object[]
      - `documentId` string — 文档id
      - `url` string — url
    - `failedInfos` object[]
      - `url` string — url
      - `failReason` string — 失败原因
  - `code` integer — 状态码
  - `message` string — 返回信息
  - `timestamp` integer — 时间戳

## Other responses

- `default` — 请求失败

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)