> ## Documentation Index
> Fetch the complete documentation index at: https://germeytechnology-docs-remove-4o-image-nav.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Publisher Publish

> Publisher Cross-Platform Automatic Publishing 集成指南 - Ace Data Cloud

## 介绍

Publisher Publish API 是 Ace Data Cloud 提供的自动化内容发布接口。通过该 API，您可以将文章一键发布到多个平台，包括知乎、CSDN、Medium、Dev.to、Reddit、微博、小红书等 13 个主流内容平台。

## 功能特点

* **多平台发布**：一次请求即可将内容发布到多个平台
* **多格式支持**：支持 Markdown、HTML 和纯文本格式
* **AI 内容优化**：可选启用 AI 自动适配各平台风格
* **异步任务**：任务提交后通过 Tasks API 查询进度
* **回调通知**：支持设置回调 URL，发布完成后自动通知

## 基本用法

### 发布到多个平台

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/publisher/publish' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Introduction to AI APIs",
    "content": "# Introduction\n\nThis article covers...",
    "content_format": "markdown",
    "channels": ["zhihu", "medium", "csdn"]
  }'
```

### 响应示例

```json theme={null}
{
  "success": true,
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab",
  "data": [
    {
      "task_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
      "channel": "zhihu",
      "state": "pending"
    },
    {
      "task_id": "a9b8c7d6-e5f4-3210-abcd-ef1234567890",
      "channel": "medium",
      "state": "pending"
    }
  ]
}
```

### 启用 AI 内容优化

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/publisher/publish' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "AI API 使用指南",
    "content": "# 指南\n\n本文介绍如何使用 AI API...",
    "channels": ["xiaohongshu", "medium"],
    "generate": true
  }'
```

设置 `generate: true` 后，系统将使用 AI 为每个平台生成适合该平台风格的内容版本。

## 支持的平台

| 平台       | channel 值   | 说明       |
| -------- | ----------- | -------- |
| 知乎       | zhihu       | 中文问答社区   |
| CSDN     | csdn        | 中文技术社区   |
| B 站      | bilibili    | 视频和文章平台  |
| 百家号      | baijiahao   | 百度内容平台   |
| 小红书      | xiaohongshu | 生活方式社区   |
| 微博       | weibo       | 中文社交平台   |
| 头条号      | toutiao     | 今日头条内容平台 |
| 稀土掘金     | juejin      | 中文技术社区   |
| Medium   | medium      | 英文博客平台   |
| Dev.to   | dev         | 英文技术社区   |
| Reddit   | reddit      | 英文论坛社区   |
| X        | x           | 社交媒体平台   |
| Facebook | facebook    | 社交媒体平台   |

## 注意事项

* 发布前需要先通过 Configs API 配置目标平台的登录凭证
* 每个任务是异步执行的，请使用 Tasks API 查询发布状态
* 建议发布前先使用 Channels API 检查可用的平台列表