AI 員工 API 文件

AI Marketer API

透過 REST API 在您的工具、工作流程和應用程式中直接呼叫 AI 行銷員工。提示詞與知識庫由平台管理，您只需傳入指令即可。

Base URL：https://aiteam.sowork.ai

下載 OpenAPI 規格

快速開始

三步驟即可開始使用 AI 員工 API：

取得 API Key

在「API Keys」頁面一鍵生成您的 API Key

選擇 AI 員工

從下方的員工列表找到適合您需求的 AI 員工 slug

發送請求

使用任何 HTTP 工具呼叫 /api/agent/chat endpoint

bash

curl -X POST https://aiteam.sowork.ai/api/agent/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "agent": "lin-szu-you",
    "message": "幫我寫一篇 RIMAY 護膚品的 Instagram 貼文，主打保濕功效"
  }'

回應範例：

json

{
  "reply": "✨ 肌膚的每一滴水分，都值得被珍惜 ✨\n\n在忙碌的日子裡，給肌膚一個深呼吸的機會。\nRIMAY 保濕精華，以天然植萃成分，\n為你的肌膚注入 72 小時持久水潤...",
  "agentName": "林思佑",
  "agentTitle": "品牌內容策略師",
  "creditsCharged": 2,
  "creditsRemaining": 348
}

認證方式

所有 API 請求都需要在 HTTP Header 中帶入 Bearer Token。

Authorization Header

http

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

安全提醒：請勿將 API Key 暴露在前端程式碼或公開的 Git 倉庫中。建議透過環境變數或後端代理呼叫。

API Endpoint

POST/api/agent/chat

Request Body

參數	類型	必填	說明
agent	string	必填	AI 員工的 slug 識別碼（見下方員工列表）
message	string	必填	您要傳給 AI 員工的指令或問題
context	string	選填	額外的背景資訊（品牌資料、產品說明等）

Response

欄位	類型	說明
reply	string	AI 員工的回應內容
agentName	string	AI 員工的中文名稱
agentTitle	string	AI 員工的職稱
creditsCharged	number	本次呼叫消耗的點數
creditsRemaining	number \| null	帳戶剩餘點數（無限點數帳戶為 null）

可用 AI 員工

以下是目前平台上所有可透過 API 呼叫的 AI 員工。使用 slug 欄位作為 API 請求中的 agent 參數。

名稱	Slug	職稱	層級
David Lin	`david-omd-2`	Google Ads Specialist	執行層
陳佳玲	`elaine-chen-ctbc-bank-tw`	APP 行銷專員	執行層
陳志明	`peter-chen-taiwan-beer-tw`	通路行銷專員	執行層
蔡佳穎	`jenny-tsai-taiwan-beer-tw`	KOL 合作專員	執行層
李建宏	`kevin-li-taiwan-beer-tw`	活動行銷專員	執行層
王雅婷	`amy-wang-taiwan-beer-tw`	社群行銷專員	執行層
江志偉	`gary-chiang-taiwan-beer-tw`	數位行銷經理	執行層
范雅慧	`helen-fan-taiwan-beer-tw`	品牌行銷總監	策略層
吳俊賢	`alex-wu-president-chain-store-tw`	內容行銷專員	執行層
張佳蓉	`carol-chang-president-chain-store-tw`	KOL 合作專員	執行層
許志豪	`david-hsu-president-chain-store-tw`	促銷活動專員	執行層
陳雅文	`wendy-chen-president-chain-store-tw`	社群行銷專員	執行層
林建志	`eric-lin-president-chain-store-tw`	數位行銷經理	執行層
蔡雅玲	`elaine-tsai-president-chain-store-tw`	行銷策略總監	策略層
劉雅琪	`grace-liu-uniqlo-taiwan-tw`	CRM 行銷專員	執行層
吳佳穎	`jenny-wu-uniqlo-taiwan-tw`	KOL 合作專員	執行層
黃志明	`peter-huang-uniqlo-taiwan-tw`	門市行銷專員	執行層
陳雅婷	`amy-chen-uniqlo-taiwan-tw`	社群行銷專員	執行層
謝建宏	`kevin-hsieh-uniqlo-taiwan-tw`	數位行銷經理	執行層
施雅芳	`fiona-shih-uniqlo-taiwan-tw`	行銷策略總監	策略層

顯示前 20 位，共 520 位 AI 員工

點數計費

每次 API 呼叫都會消耗您帳戶的點數。

每次 API 呼叫

2 點

無論 AI 員工層級，每次呼叫固定扣 2 點

創建者分潤

1 點

您的每次呼叫，AI 員工創建者自動獲得 1 點

點數購買

前往點數頁

在點數頁面購買更多點數或查看方案

錯誤代碼

HTTP 狀態	錯誤訊息	說明
401	Invalid API key	API Key 無效或已被撤銷
402	Insufficient credits	帳戶點數不足，請購買更多點數
404	Agent not found	指定的 agent slug 不存在或已下架
429	Rate limit exceeded	請求頻率過高，請稍後再試
500	Internal server error	伺服器內部錯誤，請聯繫客服

工具整合

以下是常見工具的整合方式。

n8n

自動化

在 HTTP Request 節點設定 POST 方法，加入 Authorization header，即可在自動化工作流程中呼叫 AI 員工。

Make (Integromat)

自動化

使用 HTTP 模組，設定 POST 請求到 /api/agent/chat，在 Headers 加入 Bearer Token 即可。

Zapier

自動化

使用 Webhooks by Zapier 動作，設定 POST 請求並加入 Authorization header。

ChatGPT Actions

AI 工具

在 GPTs 的 Actions 設定中，選擇「從 URL 匯入」並貼上 OpenAPI 規格網址，即可讓 GPT 在對話中呼叫 AI 員工。

查看 OpenAPI 設定說明

OpenAPI 規格

AI Marketer API 提供標準 OpenAPI 3.0 規格，可直接匯入 Postman、Insomnia 或 ChatGPT Actions，無需手動設定。

下載規格檔案

直接下載 JSON 格式的 OpenAPI 規格，匯入 Postman 或 Insomnia。

url

https://aiteam.sowork.ai/api/openapi.json

ChatGPT Actions 設定

在 GPTs 的 Actions 設定中，選擇「從 URL 匯入」並貼上以下網址：

url

https://aiteam.sowork.ai/api/openapi.json

匯入後，在 Authentication 設定中：

選擇 API Key
Auth Type 選擇 Bearer
填入您的 API Key（sk-aim-...）

規格包含：

完整的 request/response schema 定義
所有可用 AI 員工的 slug 列表（動態更新）
錯誤代碼與說明
Bearer Token 認證設定
繁體中文欄位說明

準備好開始了嗎？

取得您的 API Key，立即開始呼叫 AI 行銷員工。