建立 AI 任務

接口概述

提交一段文字以產生摘要。接口先回傳任務 ID；處理結果可按 ID 查詢。

接口資訊

AI 任務 · 建立 AI 任務

POST /v1/ai/tasks

認證方式：請求需在 Header 中攜帶 Authorization: Bearer <API_KEY>。建立類請求必須包含 Content-Type: application/json，推薦傳入 Idempotency-Key 避免重複提交。

請求參數

下表列出此接口支援的所有輸入參數及約束條件：

參數名稱	類型	約束	說明
task_type	string	必填	固定為 summarize。
input.text	string	必填	需要摘要的 UTF-8 文字，不可為空。
reference_id	string	可選	客戶系統內的關聯編號；原樣保留，方便對帳。

請求正文範例 · application/json

{
  "task_type": "summarize",
  "input": {
    "text": "請整理這段企業內部會議記錄。"
  },
  "reference_id": "case-001"
}

成功回應

狀態碼：202 Accepted

參數名稱	類型	約束	說明
id	string	必填	任務 ID，用於後續查詢。
status	string	必填	建立時為 queued。
created_at	string	必填	建立時間，ISO 8601 UTC 格式。
request_id	string	必填	本次請求的追蹤 ID。

回應正文範例 · application/json

{
  "id": "task_01JEXAMPLE",
  "status": "queued",
  "created_at": "2026-09-29T08:00:00Z",
  "request_id": "req_01JEXAMPLE"
}

調用示例

將 <API_BASE_URL> 替換為 WiseLink 分配的端點地址，將 <API_KEY> 替換為您的訪問金鑰：

請求示例 · cURL

curl -X POST "<API_BASE_URL>/v1/ai/tasks" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <UNIQUE_KEY>" \
  -d '{"task_type":"summarize","input":{"text":"請整理這段企業內部會議記錄。"},"reference_id":"case-001"}'

注意事項

對同一份請求重試時，沿用原來的 Idempotency-Key。
任務建立成功只代表已接收，不代表摘要已完成。

錯誤處理

錯誤響應說明

參數無效時返回 400 VALIDATION_ERROR；憑證缺失或失效返回 401 UNAUTHORIZED；無權訪問返回 403 FORBIDDEN；指定資源不存在返回 404 NOT_FOUND。完整錯誤碼與指數退避策略請參閱錯誤與重試指南。