开发者/云端 API

云端 API（API Key）

网页版的接口，任何机器都能调：把文章、短图文、视频稿推进字流，上传图片视频，管理发布预设；还有一个 OpenAI 兼容的 AI 接口，按云点计费。地址 https://ziliu.online/api。

创建 API Key

网页版「设置 → API Keys」
起个名字（如「OpenClaw 主控」），可以设过期时间。完整 Key（ziliu_sk_ 开头）只显示这一次，马上复制保存。
请求头带上它
Authorization: Bearer ziliu_sk_…
一个集成一个 Key
泄露或不用了直接删掉，依赖它的脚本立刻失效。库里只存哈希。

文章

方法和路径	说明
`POST /articles`	建文章：`title`、`content`（Markdown）、`status` draft / published（默认 published）、`style` 排版风格、`externalId` 可选（同一个 externalId 重复推就是更新）
`GET /articles`	列表：`?page=1&limit=20&status=draft`
`GET /articles/<id>`	一篇。`?format=inline&style=tech` 返回内联样式的公众号 HTML
`PUT /articles/<id>`	改 `title` / `content` / `status` / `style`
`DELETE /articles/<id>`	删除

curl -X POST https://ziliu.online/api/articles \
  -H "Authorization: Bearer ziliu_sk_你的Key" -H "Content-Type: application/json" \
  -d '{"title":"一人公司第一年的账单","content":"# 正文……","status":"draft","externalId":"openclaw-2026-10-21-01"}'
# {"success":true,"data":{"id":"…","title":"…","wordCount":2310, …}}

style 可选：default、minimal、elegant、tech、card、print、night、wechatHot、blogger。推进来的稿子会同步到桌面端内容库，标着「接口入库」，打开后和自己写的一样改编、配图、发布。

短图文和视频稿

方法和路径	说明
`GET /short-text/content?articleId=&platform=`	读某篇文章在某个平台的短图文版
`POST /short-text/content`	存：`articleId`、`platform`、`title`、`content`、`tags`、`images`、`coverImage`
`GET /video/content?articleId=&platform=`	读视频稿（platform：video_wechat / douyin / bilibili / xiaohongshu / youtube）
`POST /video/content`	存：`articleId`、`platform`、`videoTitle`、`videoDescription`、`speechScript`、`tags`，可选封面和预估时长

上传

方法和路径	说明
`POST /upload`	图片，`multipart/form-data` 的 `file` 字段，返回 `{ success, data: { url, fileSize, … } }`
`POST /upload-video`	视频，`file` 字段，最大 100 MB，返回 `{ success, data: { url, fileSize, … } }`
`POST /v1/files/pdf`	资料包 PDF（付费版），最大 20 MB，返回公开下载链接 `{ url }`

curl -X POST https://ziliu.online/api/upload -H "Authorization: Bearer ziliu_sk_你的Key" -F "file=@cover.png"

发布预设

方法和路径	说明
`GET /presets?platform=wechat`	某个平台的预设（默认的排前面）
`POST /presets`	新建：`name`、`platform`、`headerContent`、`footerContent`、`isDefault`、`platformConfig`
`GET / PUT / DELETE /presets/<id>`	读、改、删

AI 接口（OpenAI 兼容，按云点计费）

方法和路径	说明
`GET /v1/me`	账号、套餐、剩余云点（包月赠点和加购分开）、可用功能
`GET /v1/models`	可用模型（对外统一叫 `ziliu`，后台按任务挑模型）
`POST /v1/chat/completions`	OpenAI Chat Completions 格式，支持 `stream`；`model` 填 `ziliu` 或不填
`POST /v1/audio/transcriptions`	Whisper 格式转写，`file` 最大 25 MB，按分钟计费
`POST /v1/images/generations`	生图
`GET /v1/estimates`	各功能大概花多少云点（不要鉴权）
`GET /v1/platforms`	平台清单（字段、字数上限，不要鉴权）

用 OpenAI SDK 直接调python

from openai import OpenAI

client = OpenAI(base_url='https://ziliu.online/api/v1', api_key='ziliu_sk_你的Key')
res = client.chat.completions.create(model='ziliu', messages=[{'role': 'user', 'content': '给这篇稿子起 5 个标题：……'}])
print(res.choices[0].message.content)