docs: add search endpoint documentation with chunk details
This commit is contained in:
@@ -73,7 +73,66 @@ curl -s -H "X-API-Key: muser_68600856036340bcafc01930eb4bd839_1774418104_97221b6
|
|||||||
#### GET /api/v1/videos/:uuid
|
#### GET /api/v1/videos/:uuid
|
||||||
取得單一影片詳情
|
取得單一影片詳情
|
||||||
|
|
||||||
### 3.2 任務相關
|
### 3.2 搜尋與分段查詢
|
||||||
|
|
||||||
|
#### POST /api/v1/search
|
||||||
|
向量搜尋,查詢分段詳情
|
||||||
|
|
||||||
|
**請求範例**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"query": "關鍵字",
|
||||||
|
"limit": 10
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**回應範例**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"results": [
|
||||||
|
{
|
||||||
|
"uuid": "5dea6618a606e7c7",
|
||||||
|
"chunk_id": "time_00001",
|
||||||
|
"chunk_type": "time",
|
||||||
|
"start_time": 0.0,
|
||||||
|
"end_time": 10.0,
|
||||||
|
"text": "分段內容文字",
|
||||||
|
"score": 0.95
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### POST /api/v1/n8n/search
|
||||||
|
n8n 專用搜尋(包含縮圖網址)
|
||||||
|
|
||||||
|
**請求範例**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"query": "關鍵字",
|
||||||
|
"limit": 10
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**回應範例**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"hits": [
|
||||||
|
{
|
||||||
|
"uuid": "5dea6618a606e7c7",
|
||||||
|
"chunk_id": "time_00001",
|
||||||
|
"chunk_type": "time",
|
||||||
|
"start_time": 0.0,
|
||||||
|
"end_time": 10.0,
|
||||||
|
"text": "分段內容文字",
|
||||||
|
"score": 0.95,
|
||||||
|
"thumbnail_url": "https://..."
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.3 任務相關
|
||||||
|
|
||||||
#### GET /api/v1/jobs/:uuid
|
#### GET /api/v1/jobs/:uuid
|
||||||
查詢處理任務狀態
|
查詢處理任務狀態
|
||||||
@@ -146,7 +205,7 @@ curl -s -H "X-API-Key: ..." \
|
|||||||
|
|
||||||
**注意**: 此操作會刪除影片及其所有分段、處理結果、縮圖等關聯資料,**無法復原**。
|
**注意**: 此操作會刪除影片及其所有分段、處理結果、縮圖等關聯資料,**無法復原**。
|
||||||
|
|
||||||
### 3.4 健康檢查
|
### 3.5 健康檢查
|
||||||
|
|
||||||
#### GET /health
|
#### GET /health
|
||||||
服務健康狀態(**無需認證**)
|
服務健康狀態(**無需認證**)
|
||||||
|
|||||||
Reference in New Issue
Block a user