WebOS技能：网页发布
文汇百川WebOS「技能」支持通过API接口将HTML、Markdown、JSON、图片等一键发布为在线URL，提供标准接口和Coze平台适配接口，方便在各类工作流和平台中调用。
📄
html2url
标准接口：HTML → 在线网页
📝
md2url
标准接口：Markdown → 在线文档
📊
json2url
标准接口：JSON → 在线文件
📁
file2url
标准接口：文件 → 在线文件
🤖
coze_html2url
Coze适配：HTML → 在线网页
🤖
coze_md2url
Coze适配：Markdown → 在线文档
🤖
coze_json2url
Coze适配：JSON → 在线文件
🤖
coze_file2url
Coze适配：文件URL → 在线文件
使用示例
下面是一段可以直接发给 AI（如 ChatGPT、Claude、龙虾等）的提示词。复制这段文字，AI 会自动帮你查询天气、生成网页，并调用 WebOS 技能发布为在线链接。
前置条件：需要先在 AI 工具中配置好 WebOS 技能（系统 ID：
S123456，令牌：tokenxxxxx）。提示词示例
提示词 查询一下北京今天及未来七天的天气情况，生成一个精美的 HTML 网页，网页标题为"北京今天及未来七天的天气情况"，包含天气状况、温度、风力等信息。
生成完成后，请使用 webos 技能将这个网页发布为在线链接：
- 系统 ID：S123456
- 令牌：tokenxxxxx
- 文件名：beijing-weather.html（可不写）
最后把发布成功的在线链接发给我。
生成完成后，请使用 webos 技能将这个网页发布为在线链接：
- 系统 ID：S123456
- 令牌：tokenxxxxx
- 文件名：beijing-weather.html（可不写）
最后把发布成功的在线链接发给我。
AI 会帮你做什么？
1 查询天气数据
AI 自动调用天气查询工具，获取北京实时天气。
2 生成 HTML 网页
AI 根据天气数据自动生成一个美观的网页，包含天气图标、温度、风力等。
3 调用 WebOS 技能发布
AI 自动调用 WebOS 技能，将网页上传到你的网站库，生成可访问的在线链接。
4 返回结果
AI 把最终的在线链接发给你，直接点击即可访问。
结果示例：AI 会返回类似这样的链接给你：
https://demo-coze.publicos.cn/weather/beijing-weather.html还能做什么？
你可以用类似的提示词，让 AI 帮你生成各种类型的网页并发布：
- 生成个人简历网页并发布
- 生成产品介绍页面并发布
- 生成数据报告可视化页面并发布
- 生成 Markdown 文档并发布
- 生成 JSON 数据接口并发布
快速上手
使用技能接口前，您需要先获取系统ID（osid）和网站库令牌（token）。以下是完整的操作流程：
2 进入系统桌面，找到【网站库】和【设置】
在系统中，点击左下角的【开始】按钮，可以展开开始菜单，其中包含【网站库】和【设置】两个关键入口：
- 网站库 — 文件保存的空间，每个网站库都有独立的令牌（token）
- 设置 — 可以查看系统ID、管理成员及其权限
3 查看网站库列表，获取 Token
点击【网站库】后，会显示所有已添加的网站库列表。每个网站库都有一个专属的 token（令牌），这就是调用接口时需要传入的关键参数。
4 设置网站库/文件的公开访问权限
每个网站库都可以设置是否对外公开：
- 外部公开 = 支持：公网用户无需登录即可访问
- 外部公开 = 禁止：只有系统成员可以访问
右键点击网站库或者具体文件，均可看到【公网地址访问】等菜单选项。
完成以上步骤后，您就获得了：
• 系统ID（osid） — 在账户中心或系统设置中可查
• 网站库令牌（token） — 在网站库列表中获取
接下来就可以调用接口了！
• 系统ID（osid） — 在账户中心或系统设置中可查
• 网站库令牌（token） — 在网站库列表中获取
接下来就可以调用接口了！
标准接口
标准接口通过 POST 请求调用，参数以 multipart/form-data 或 application/x-www-form-urlencoded 方式提交。
html2url - 将HTML代码发布为在线网页
POST /html2url?osid=S12345 标准接口：发布HTML为在线网页
将HTML代码内容发布为在线网页，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
请求参数（Form）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
html | string | 必填 | HTML代码内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录，支持 / 或 \ |
请求示例
JSON { "token": "your_token_here", "html": "<h1>Hello World</h1><p>我的第一个网页</p>", "filename": "hello.html", "path": "/demo" }
注：标准接口通过 form-data 提交参数，以上仅为参数结构示意。
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/hello.html" }
md2url - 将Markdown文本发布为在线文档
POST /md2url?osid=S12345 标准接口：发布Markdown为在线文档
将Markdown文本内容发布为在线文档，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
请求参数（Form）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
md | string | 必填 | Markdown内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "md": "# 标题\n\n这是一段Markdown内容\n\n- 列表项1\n- 列表项2", "filename": "readme.md", "path": "/docs" }
注：标准接口通过 form-data 提交参数，以上仅为参数结构示意。
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/readme.md" }
json2url - 将JSON文本发布为在线文件
POST /json2url?osid=S12345 标准接口：发布JSON为在线文件
将JSON内容发布为在线文件，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
请求参数（Form）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
json | string | 必填 | JSON内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "json": "{\"name\": \"张三\", \"age\": 25, \"city\": \"北京\"}", "filename": "data.json", "path": "/api" }
注：标准接口通过 form-data 提交参数，以上仅为参数结构示意。
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/data.json" }
file2url - 将文件发布为在线文件
POST /file2url?osid=S12345 标准接口：发布文件为在线文件
将文件发布为在线文件，支持 jpg/png/gif/webp/html/json/xml/txt/md。
提示：不同 OS 版本限制的文件大小不同，请注意文件大小上限。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
请求参数（Form）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
file | file | 必填 | 上传文件（multipart/form-data） |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
bash curl -X POST "https://api.publicos.cn/api/web/file2url?osid=S12345" \ -F "token=your_token_here" \ -F "file=@image.png" \ -F "filename=my-image.png" \ -F "path=/images"
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/my-image.png" }
支持的文件格式
| 类型 | 扩展名 | 说明 |
|---|---|---|
| 图片 | jpg, png, gif, webp | 支持常见图片格式 |
| 网页 | html | HTML网页文件 |
| 数据 | json, xml | 结构化数据文件 |
| 文本 | txt | 纯文本文件 |
| 文档 | md | Markdown文档 |
Coze 适配接口
Coze 适配接口专为 Coze 平台设计，通过 POST 请求调用，参数以 application/json 格式在 Body 中提交，同时 Query 中携带 osid。
coze_html2url - 将HTML代码发布为在线网页
POST /coze/html2url?osid=S12345 Coze适配：发布HTML为在线网页
将HTML代码内容发布为在线网页，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
Body 参数（JSON）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
html | string | 必填 | HTML代码内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "html": "<h1>Hello World</h1><p>我的第一个网页</p>", "filename": "hello.html", "path": "/demo" }
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/hello.html" }
coze_md2url - 将Markdown文本发布为在线文档
POST /coze/md2url?osid=S12345 Coze适配：发布Markdown为在线文档
将Markdown文本内容发布为在线文档，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
Body 参数（JSON）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
md | string | 必填 | Markdown内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "md": "# 标题\n\n这是一段Markdown内容\n\n- 列表项1\n- 列表项2", "filename": "readme.md", "path": "/docs" }
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/readme.md" }
coze_json2url - 将JSON文本发布为在线文件
POST /coze/json2url?osid=S12345 Coze适配：发布JSON为在线文件
将JSON内容发布为在线文件，生成可直接访问的URL链接。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
Body 参数（JSON）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
json | string | 必填 | JSON内容 |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "json": "{\"name\": \"张三\", \"age\": 25, \"city\": \"北京\"}", "filename": "data.json", "path": "/api" }
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/data.json" }
coze_file2url - 将文件发布为在线文件
POST /coze/file2url?osid=S12345 Coze适配：发布文件为在线文件
将文件发布为在线文件（Coze适配版，通过文件 URL 传入），支持 jpg/png/gif/webp/html/json/xml/txt/md。
提示：不同 OS 版本限制的文件大小不同，请注意文件大小上限。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
osid | string | 必填 | 系统ID，示例：S12345 |
Body 参数（JSON）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 网站库令牌 |
file_url | string | 必填 | 文件的URL地址（需先下载） |
filename | string | 可选 | 文件名，不填则生成随机名称 |
path | string | 可选 | 存储目录，不填则存根目录 |
请求示例
JSON { "token": "your_token_here", "file_url": "https://example.com/image.png", "filename": "my-image.png", "path": "/images" }
响应示例（成功）
JSON { "code": 0, "msg": "success", "url": "https://xxx.publicos.cn/xxx/my-image.png" }
支持的文件格式
| 类型 | 扩展名 | 说明 |
|---|---|---|
| 图片 | jpg, png, gif, webp | 支持常见图片格式 |
| 网页 | html | HTML网页文件 |
| 数据 | json, xml | 结构化数据文件 |
| 文本 | txt | 纯文本文件 |
| 文档 | md | Markdown文档 |
响应说明
所有接口统一使用以下响应格式：
| 字段名 | 类型 | 说明 |
|---|---|---|
code | integer | 状态码，0 表示成功，其他数字表示失败 |
msg | string | 响应提示消息 |
url | string | 成功时返回在线文件的URL地址 |
响应示例（失败）
JSON { "code": 1001, "msg": "token无效" }
注意事项
Token 安全：请妥善保管您的 token，不要在公开场合泄露。每个网站库拥有独立的令牌。
文件大小限制：不同 OS 版本（个人成长OS、家庭成长OS、团队进阶OS、企业进阶OS）对文件大小限制不同。
文件名规则：如果不填写
filename，系统会自动生成一个随机文件名。 路径规则：
path 参数用于指定发布后的文件存放路径，不填写则默认存放在根目录下。 Coze 接口：必须携带 Query 参数
osid，Body 中携带 token。 标准接口：
token 作为请求参数直接传入。