AIEO 平台提供标准化的 Webhook 回调接口，便于您将生成结果对接到自有系统或自动化流程。
所有 API 请求均需携带您的账户安全密钥（API Key）。您的密钥可在「品牌配置 → 高级选项」中查看或重新生成。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json| 限制维度 | 默认限额 | 说明 |
|---|---|---|
| 任务创建速率 | 60 次 / 分钟 | 单账号每分钟最多创建 60 条新任务 |
| 批量发车 | 50 条 / 批次 | 单次批量发车最多 50 条任务 |
| 并发生成 | 依套餐而定 | 同时在执行的生成任务数，超出后进入等待队列 |
| 查询接口 | 300 次 / 分钟 | 任务状态查询、文章内容拉取等读接口 |
超出限流后，接口返回 HTTP 429 Too Many Requests，响应体为：
{
"success": false,
"message": "请求过于频繁，请稍后重试",
"retry_after": 30
}retry_after 字段表示建议的等待秒数，请在客户端实现自动退避重试（Exponential Backoff）。
| 端点 | 方法 | 说明 |
|---|---|---|
api/article_receiver.php | POST | 接收 AI 引擎回传的文章内容（系统内部回调端点） |
api/image_receiver.php | POST | 接收图片生成结果（系统内部回调端点） |
api/get_task_progress.php | GET | 查询指定任务的当前进度和状态 |
api/get_article_raw.php | GET | 获取指定任务的文章原始 HTML 内容 |
api/publish.php | POST | 将指定文章推送到已绑定的 WordPress 站点 |
| HTTP 状态 | 含义 | 常见原因 |
|---|---|---|
200 | 成功 | 接口正常返回，查看 success 字段确认业务状态 |
401 | 未认证 | API Key 缺失、错误或已失效 |
403 | 无权限 | 操作了不属于您的资源 |
429 | 限流 | 请求频率超出限制，等待后重试 |
500 | 服务器错误 | 后端异常，请联系客服并附上请求 ID |