文章提交

POST#21api ATC_BASE

https://member.bilibili.com/arcopen/fn/article/add

开放能力 / 专栏稿件管理 / 文章管理

调用该接口完成文章稿件投递若需要传入的图片url，请传入经过【图片上传】接口生成的url 文章稿件提交之后会存在审核过程，期间不对外开放

body 参数

名称	类型	必填	说明
title	string	是	文章标题，建议30字以内，最多不超过40字
category	int	是	文章分类，通过categories接口获取，填写子分类id
template_id	int	是	选择稿件模板： 3-封面三图； 4-封面单图或无封面图且banner_url/top_video_bvid不为空； 5-封面无图且banner_url/top_video_bvid都为空，平台生成默认封面
summary	string	是	文章简介，字数不少于200字
content	string	是	正文内容，字数200-40000，或者至少添加三张图片添加图片模板：<figure class="img-box" contenteditable="false"><img src="${图片url}"><figcaption class="caption" contenteditable="">${图片描述信息}</figcaption></figure> 添加卡片模板：从卡片信息接口获取
banner_url	string	否	头图url，与top_video_bvid可都不填写，或者只能二选一推荐上传960 x 540像素图片，超过此像素会自动居中剪裁
original	int	否	是否原创：0-非原创 1-原创默认0
image_urls	string	否	封面默认使用正文文字图片，多个图片用英文逗号分割图片url为通过图片上传接口返回的url地址若单封面图，推荐上传640x188像素图片（非Gif图），超过此像素会自动居中剪裁若三封面图，正文需存在至少3张尺寸为188 x 188像素图片（非Gif图），超过此像素会自动居中剪裁，对应的图片url为本字段的图片url。
tags	string	否	用户自定义标签，多标签情况下用英文逗号分割
list_id	int	否	文集id
up_closed_reply	int	否	是否up主关闭评论区：0-否 1-是默认0
top_video_bvid	string	否	头部视频bvid，与banner_url可都不填写，或者只能二选一

响应字段

名称	类型	必填	说明
id	int	否	新建的文章id

调用方式

javascript

// 让 AI 直接调（需要开放平台凭据）
bili_api_call { "ref": "21", "query": {…}, "body": {…} }

// 只看将要发出的请求（不需要凭据）
bili_api_call { "ref": "21", "dryRun": true }

// 生成完整调用代码
bili_codegen { "ref": "21", "lang": "python" }

官方请求示例

bash

curl --location --request POST 'https://member.bilibili.com/arcopen/fn/article/add' \
--header 'Accept: application/json' \
--header 'Access-Token: a24e56a0fc0093668bca0f3a15410ea2' \
--header 'Authorization: 950a03adb287904a93bcffd7e4abf57a4c2ef0608bf1f95f3bcb2c278ae532be' \
--header 'X-Bili-Accesskeyid: 93a0f774fae84e6c' \
--header 'X-Bili-Content-Md5: d41d8cd98f00b204e9800998ecf8427e' \
--header 'X-Bili-Signature-Method: HMAC-SHA256' \
--header 'X-Bili-Signature-Nonce: 1730185575446751000' \
--header 'X-Bili-Signature-Version: 2.0' \
--header 'X-Bili-Timestamp: 1730185575' \
--header 'Host: member.bilibili.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: multipart/form-data; boundary=--------------------------690347605097214386959433' \
--form 'title="开放平台测试标题"' \
--form 'category="1"' \
--form 'template_id="5"' \
--form 'summary="注意简介字数"' \
--form 'content="开放平台正文测试"' \

原始文档：021_文章提交.md（4295 字节）。用 bili_docs_get { "ref": "21" } 读全文，或用 bili_api_spec { "ref": "21" } 取结构化规格。