文字內容篩選 API

content-filter-text-standard 文字內容偵測模型的完整 API 參考。

概覽

Content Filter Text 會針對支援的內容安全分類檢查文字輸入，並回傳同步偵測結果。目前的偵測類型為 nsfw。

端點

http複製
POST /api/v1/content/filter

驗證

http複製
Authorization: Bearer YOUR_API_KEY

請求參數

必填

不支援

請求範例

javascript複製
const response = await fetch('https://api.flaq.ai/api/v1/content/filter', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'content-filter-text-standard',
    type: 'nsfw',
    text: 'Sample text to check'
  })
});

const result = await response.json();
console.log(result.data);

回應格式

json複製
{
  "code": 0,
  "message": "success",
  "data": {
    "type": "nsfw",
    "flagged": false,
    "credits": 200,
    "detail": {
      "text": {
        "checked": true,
        "flagged": false,
        "score": 0,
        "level": "none"
      },
      "images": []
    }
  }
}

回應資料

偵測結果

結果說明

• 如果 checked 為 false，表示該項目未成功檢查。在這種情況下，score 可能為 0 且 level 可能為 "none"，但該項目應視為偵測失敗，而不是無風險結果。
• flagged 僅描述項目完成檢查後的偵測結果。
• level 是由偵測分數推導出的易於顯示的風險等級。

錯誤處理

如果請求失敗，API 會回傳非零的 code 或非 2xx 的 HTTP 狀態。請查看 message 欄位取得詳細資訊。