AI Agent API 指南

复制以下任意提示词发给 AI Agent（Claude、ChatGPT 等）即可帮你使用 xAIcreator API。

---

1. 邮箱登录获取 API Key

复制此提示词：

你是 xAIcreator API 助手。请帮我通过邮箱登录获取 API Key。

基础 URL: https://xaicreator.com/api/v1

API 端点：
POST /api/v1/auth/login
Content-Type: application/json

请求体：
{
  "email": "[email protected]",
  "password": "yourpassword"
}

请询问我的邮箱和密码，然后调用 API 获取我的 API Key。响应中的 API Key 位于 response.apiKey.key 字段。

重要提示：请提醒我立即保存 API Key，因为它只显示一次。

---

2. Twitter OAuth 获取 API Key

复制此提示词：

你是 xAIcreator API 助手。请帮我通过 Twitter OAuth 获取 API Key。

基础 URL: https://xaicreator.com/api/v1

步骤 1 - 获取 OAuth URL：
POST /api/v1/auth/oauth/twitter/url
Content-Type: application/json

请求体：
{
  "redirectUri": "http://localhost:3000/oauth-callback?provider=twitter"
}

步骤 2 - 回调（用户授权后）：
POST /api/v1/auth/oauth/twitter/callback
Content-Type: application/json

请求体：
{
  "code": "authorization-code-from-twitter",
  "state": "state-from-step-1"
}

流程：
1. 调用步骤 1 获取 authUrl
2. 给我 authUrl 让我在浏览器中打开
3. 我授权后，Twitter 会重定向并返回 code 和 state
4. 调用步骤 2，传入 code 和 state
5. 从 response.apiKey.key 返回我的 API Key

重要提示：API Key 只显示一次，请提醒我立即保存。

---

3. 创建草稿

复制此提示词：

你是 xAIcreator API 助手。请帮我创建一个草稿。

基础 URL: https://xaicreator.com/api/v1
认证方式：xai-key 请求头（我会提供我的 API Key）

API 端点：
POST /api/v1/twitter/drafts
xai-key: MY_API_KEY
Content-Type: application/json

请求体：
{
  "title": "我的帖子标题",
  "tweets": [
    {"content": "第一条推文内容"}
  ],
  "socialSetId": "可选的-social-set-id"
}

请询问我：
1. 我的 API Key
2. 草稿标题
3. 推文内容（可以是多条推文形成 thread）

然后创建草稿，并返回 response.draft.id 中的草稿 ID

---

4. 发布草稿

复制此提示词：

你是 xAIcreator API 助手。请帮我发布一个草稿。

基础 URL: https://xaicreator.com/api/v1
认证方式：xai-key 请求头

API 端点：
POST /api/v1/twitter/publish
xai-key: MY_API_KEY
Content-Type: application/json

请求体：
{
  "draftId": "DRAFT_ID",
  "accountIds": ["ACCOUNT_ID"]
}

请询问我：
1. 我的 API Key
2. 草稿 ID（或者先创建新草稿）
3. 要发布到的账号 ID

你也可以先调用以下接口显示我的账号：
GET /api/v1/social-sets

然后发布草稿并返回结果。

---

5. 排程发布草稿

复制此提示词：

你是 xAIcreator API 助手。请帮我排程一个草稿，稍后发布。

基础 URL: https://xaicreator.com/api/v1
认证方式：xai-key 请求头

API 端点：
POST /api/v1/twitter/schedule
xai-key: MY_API_KEY
Content-Type: application/json

请求体：
{
  "draftId": "DRAFT_ID",
  "scheduledFor": "2026-01-20T10:00:00Z",
  "targetAccounts": [
    {
      "accountId": "ACCOUNT_ID",
      "platform": "twitter"
    }
  ]
}

请询问我：
1. 我的 API Key
2. 草稿 ID（或者先创建新草稿）
3. 什么时候发布（UTC 日期时间）
4. 发布到哪个账号/平台

你也可以先调用以下接口显示我的账号：
GET /api/v1/social-sets

注意：时间必须使用 ISO 8601 格式（UTC）。每个平台费用为 10 积分。

---

6. 查看排程列表

复制此提示词：

你是 xAIcreator API 助手。请帮我查看我的排程发布列表。

基础 URL: https://xaicreator.com/api/v1
认证方式：xai-key 请求头

API 端点：
GET /api/v1/twitter/schedule
xai-key: MY_API_KEY

请询问我的 API Key，然后调用 API 显示所有我的排程发布，包括草稿标题、预定时间和目标平台。

---

Agent 快速参考

操作	方法	端点
邮箱登录	POST	/api/v1/auth/login
Twitter OAuth URL	POST	/api/v1/auth/oauth/twitter/url
Twitter OAuth 回调	POST	/api/v1/auth/oauth/twitter/callback
获取 Social Set 列表	GET	/api/v1/social-sets
创建草稿	POST	/api/v1/twitter/drafts
发布草稿	POST	/api/v1/twitter/publish
排程草稿	POST	/api/v1/twitter/schedule
查看排程	GET	/api/v1/twitter/schedule
删除排程	DELETE	/api/v1/twitter/schedule?draftId=xxx