介绍
# BlogBurst - AI Content Creation & Distribution
BlogBurst 帮助您从创意到发布内容，覆盖 9 个社交平台。典型的工作流程如下：
1. **头脑风暴**：通过 AI 聊天构思标题 2. **生成**：从标题生成完整的博客文章 3. **创建**：为 Twitter、LinkedIn、TikTok 等创建针对平台优化的帖子
您也可以通过 URL 改编现有的文章。
## 设置
1. 在 [blogburst.ai](https://blogburst.ai) 注册 2. 前往 Dashboard > API Keys 以生成密钥 3. 设置环境变量： ```bash export BLOGBURST_API_KEY="your-key" ```
所有 API 请求均使用请求头：`X-API-Key: $BLOGBURST_API_KEY`
基础 URL：`https://api.blogburst.ai/api/v1`
---
## API 1: 头脑风暴标题
与 AI 对话，为您的内容构思一个引人注目的标题。
**端点**：`POST /chat/title`
**请求**： ```json { "messages": [ {"role": "user", "content": "I want to write about AI in healthcare"} ], "language": "en" } ```
这是一个多轮对话。每次发送完整的消息历史： ```json { "messages": [ {"role": "user", "content": "I want to write about AI in healthcare"}, {"role": "assistant", "content": "Great topic! What aspect interests you most?"}, {"role": "user", "content": "AI helping doctors diagnose diseases faster"} ], "language": "en" } ```
**响应**： ```json { "success": true, "reply": "Here are some title ideas based on AI-assisted diagnosis...", "suggested_titles": [ "How AI Detects What Doctors Miss in 5 Seconds", "Medical AI: From Assistant to Lifesaver", "When AI Becomes Your First Doctor" ], "usage": {"tokens_used": 350, "cost": 0.001, "model": "gemini-2.5-flash"} } ```
**何时使用**：当用户需要构思主题或标题方面的帮助，或者说诸如“帮我头脑风暴”、“我该写点什么”、“建议一些关于 X 的标题”之类的话时。
---
## API 2: 生成博客文章
从主题或标题生成完整的博客文章。
**端点**：`POST /blog/generate`
**请求**： ```json { "topic": "How AI Detects What Doctors Miss in 5 Seconds", "tone": "professional", "language": "en", "length": "medium" } ```
**参数**： - `topic`（必填）：标题或主题（5-500 个字符） - `tone`：professional（专业） | casual（随意） | witty（风趣） | educational（教育） | inspirational（励志）（默认：professional） - `language`：语言代码，例如 "en", "zh"（默认：en） - `length`：short（短，500-800 字） | medium（中，1000-1500 字） | long（长，2000-3000 字）（默认：medium）
**响应**： ```json { "success": true, "title": "How AI Detects What Doctors Miss in 5 Seconds", "content": "Full markdown blog post content here...", "summary": "A concise summary of the article...", "keywords": ["AI", "healthcare", "diagnosis", "medical AI"], "usage": {"tokens_used": 2500, "cost": 0.005, "model": "gemini-2.5-flash"} } ```
**何时使用**：当用户想要根据主题生成博客文章、文章或长篇内容时。
---
## API 3: 生成平台内容
根据主题生成针对多个社交平台的优化内容。这是主要的内容分发端点。
**端点**：`POST /blog/platforms`
**请求**： ```json { "topic": "How AI Detects What Doctors Miss in 5 Seconds", "platforms": ["twitter", "linkedin", "bluesky", "telegram", "discord"], "tone": "professional", "language": "en" } ```
**参数**： - `topic`（必填）：标题或主题（5-500 个字符） - `platforms`（必填）：由 1-9 个平台组成的数组，可选自：twitter, linkedin, reddit, bluesky, threads, telegram, discord, tiktok, youtube - `tone`：professional | casual | witty | educational | inspirational（默认：professional） - `language`：语言代码（默认：en）
**响应**： ```json { "success": true, "topic": "How AI Detects What Doctors Miss in 5 Seconds", "twitter": { "thread": [ "1/ AI can now detect diseases that doctors miss. Here's how it's saving lives...", "2/ A study found AI caught 95% of early-stage cancers, vs 85% for radiologists.", "3/ The key? AI analyzes millions of images. A doctor sees thousands in a lifetime." ] }, "linkedin": { "post": "I've been researching AI in healthcare for 2 years.\n\nThe results are staggering...", "hashtags": ["#AIHealthcare", "#MedTech", "#DigitalHealth"] }, "bluesky": { "posts": ["AI is quietly revolutionizing medical diagnosis. Here's what most people don't know..."] }, "telegram": { "post": "**AI in Medical Diagnosis: The Silent Revolution**\n\nDoctors are getting a powerful new ally..." }, "discord": { "post": "Hey everyone! Wanted to share something fascinating about AI in healthcare..." }, "reddit": { "title": "How AI is detecting diseases doctors miss - a deep dive", "body": "I've been following AI in healthcare closely and wanted to share...", "suggestedSubreddits": ["r/artificial", "r/healthcare", "r/technology"] }, "tiktok": { "hook": "Did you know AI can detect cancer faster than a doctor?", "script": "Here's something wild. AI systems can now...", "caption": "AI is changing medicine forever", "hashtags": ["#AI", "#Healthcare", "#MedTech", "#Science"] }, "youtube": { "title": "How AI Detects What Doctors Miss", "description": "In this video, we explore how artificial intelligence...", "script": "What if I told you that an AI can spot a disease...", "tags": ["AI healthcare", "medical AI", "diagnosis"] }, "usage": {"tokens_used": 3000, "cost": 0.006, "model": "gemini-2.5-flash"} } ```
**何时使用**：当用户想要创建社交媒体帖子、跨平台分发内容，或者说诸如“为 Twitter 和 LinkedIn 创建关于 X 的帖子”、“生成社交内容”、“帮我在所有平台上发布关于 X 的内容”之类的话时。
---
## API 4: 改编现有内容
将现有的博客文章或文章转换为针对平台优化的帖子。
**端点**：`POST /repurpose`
**使用 URL 的请求**： ```json { "content": "https://myblog.com/my-article", "platforms": ["twitter", "linkedin", "bluesky"], "tone": "casual", "language": "en" } ```
**使用文本的请求**： ```json { "content": "Your full article text here (minimum 50 characters)...", "platforms": ["twitter", "linkedin", "bluesky"], "tone": "casual", "language": "en" } ```
**参数**： - `content`（必填）：文章 URL 或全文 - `platforms`（必填）：由以下平台组成的数组：twitter, linkedin, reddit, bluesky, threads - `tone`：professional | casual | witty | educational | inspirational - `language`：语言代码（默认：en）
**响应**：格式与 API 3 相同（每个请求平台对应的特定平台内容）。
**何时使用**：当用户提供 URL 或粘贴现有内容，并希望将其适配到社交平台时。
---
## API 5: 发布到已连接的平台
将内容直接发布到用户已连接的社交媒体账户。
**重要**：使用此 API 之前，用户必须先在 [blogburst.ai/dashboard/connections](https://blogburst.ai/dashboard/connections) 连接他们的社交媒体账户。如果没有连接账户，发布将会失败。
### 检查已连接的账户
**端点**：`GET /publish/connected`
**响应**： ```json { "platforms": [ { "platform": "bluesky", "username": "@user.bsky.social", "connected_at": "2026-02-01T10:00:00Z", "capabilities": {"text": true, "images": true, "video": true} }, { "platform": "telegram", "username": "MyChannel", "connected_at": "2026-02-01T10:00:00Z", "capabilities": {"text": true, "images": true, "video": true} } ] } ```
**何时使用**：在发布之前，调用此接口以检查用户已连接的平台。如果没有连接任何平台，请告知用户先访问 https://blogburst.ai/dashboard/connections 连接他们的账户。
### 发布内容
**端点**：`POST /publish`
**请求**： ```json { "platforms": ["bluesky", "telegram", "discord"], "content": "Your post content here", "image_urls": ["https://example.com/image.jpg"], "video_url": null } ```
**参数**： - `platforms`（必填）：要发布到的已连接平台 ID 数组 - `content`（必填）：要发布的文本内容 - `image_urls`（可选）：要附加的图片 URL 数组 - `video_url`（可选）：要附加的视频 URL - `reddit_subreddit`（可选）：Reddit 帖子的子版块（subreddit）名称 - `reddit_title`（可选）：Reddit 帖子的标题
**响应**： ```json { "total": 3, "successful": 2, "failed": 1, "results": [ {"platform": "bluesky", "success": true, "post_url": "https://bsky.app/..."}, {"platform": "telegram", "success": true, "post_url": "https://t.me/..."}, {"platform": "discord", "success": false, "error": "Webhook expired"} ] } ```
**何时使用**：在使用 API 3 或 API 4 生成内容后，当用户想要将其实际发布到其已连接的平台时。始终先使用 `GET /publish/connected` 检查已连接的账户。
---
## 推荐的工作流程
为了获得最佳效果，请引导用户完成以下流程：
1. 询问他们想要创建关于什么主题的内容 2. 调用 **API 1** (`/chat/title`) 共同构思标题 3. 一旦他们选定标题，调用 **API 3** (`/blog/platforms`) 为他们选择的平台生成内容 4. 按平台分类展示生成的内容 5. 如果用户想要发布，首先调用 `GET /publish/connected` 检查连接了哪些账户 6. 如果已连接账户，使用生成的内容针对每个平台调用 **API 5** (`/publish`) 7. 如果没有连接账户，告知用户：“请先在 https://blogburst.ai/dashboard/connections 连接您的社交媒体账户”
如果用户已经有博客文章 URL，请跳转到 **API 4** (`/repurpose`)。
如果用户首先想要一篇完整的博客文章，请在步骤 3 之前使用 **API 2** (`/blog/generate`)。
**关于发布的说明**：每个平台接收为其量身定制的内容。例如，将 Twitter 串文发送给 Twitter，将 LinkedIn 帖子文本发送给 LinkedIn，以此类推。切勿将相同的原始内容发送给所有平台 —— 使用 API 3 提供的平台特定输出。
## 支持的平台
| 平台 | ID | 生成 | 自动发布 | 备注 | |----------|-----|----------|-------------|-------| | Twitter/X | twitter | 是 | 是 | 带钩子的串文（280 字符/推文） | | LinkedIn | linkedin | 是 | 即将推出 | 专业见解 + 标签 | | Bluesky | bluesky | 是 | 是 | 简短真实的帖子（300 字符） | | Telegram | telegram | 是 | 是 | 富格式广播 | | Discord | discord | 是 | 是 | 社区友好的公告 | | Reddit | reddit | 是 | 等待 API | 讨论帖 + 子版块建议 | | TikTok | tiktok | 是 | 是 | 钩子 + 脚本 + 标题 + 标签 | | YouTube | youtube | 是 | 是 | 标题 + 描述 + 脚本 + 标签 | | Threads | threads | 是 | 即将推出 | 对话式帖子 |
## 链接
- 网站：https://blogburst.ai - API 文档：https://api.blogburst.ai/docs - 连接账户：https://blogburst.ai/dashboard/connections - GitHub：https://github.com/shensi8312/blogburst-openclaw-skill