跳转到内容
NoteNowNoteNow Docs

AI 与视频 API

前置：$BASE、$TOKEN 已就绪。

AI 对话

Section titled “AI 对话”

POST /api/ai/chat

请求

Section titled “请求”
{
  "message": "帮我提炼三个要点",
  "context": "",
  "note_id": "note_xxx",
  "local_context": "",
  "selected_text": "",
  "prompt_preset": "",
  "history": []
}

message 必填；note_id / selected_text / history 用于注入上下文。

响应

Section titled “响应”
{
  "reply": "三个要点是……",
  "sources": []
}

curl

Section titled “curl”
终端窗口
curl -sS "$BASE/api/ai/chat" \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": "把大纲扩写成可发布的摘要",
    "note_id": "note_xxx",
    "selected_text": "",
    "history": []
  }'

划词动作 / 转写配置

Section titled “划词动作 / 转写配置”
方法 路径 说明
POST /api/ai/selection-action 对选中文本执行预设动作
GET /api/ai/transcriber-config 读取转写配置
PUT /api/ai/transcriber-config 更新转写配置
终端窗口
curl -sS "$BASE/api/ai/transcriber-config" \
  -H "Authorization: $TOKEN"

视频任务

Section titled “视频任务”
方法 路径 说明
GET /api/video/tasks 任务列表
POST /api/video/tasks/upload 上传创建任务
POST /api/video/tasks/url URL 创建任务
GET /api/video/tasks/{task_id} 任务详情
POST /api/video/tasks/{task_id}/retry 重试
POST /api/video/transcribe 转写
POST /api/video/transcribe-url URL 转写
POST /api/video/analyze 分析转写
POST /api/video/analyze/tasks 创建分析任务
GET /api/video/analyze/tasks/{task_id} 分析详情
POST /api/video/analyze/tasks/{task_id}/retry 重试分析
POST /api/video/check-cloud-drive 检查网盘链接

典型流程

Section titled “典型流程”
终端窗口
# 1) 创建 URL 任务（具体 body 字段见 /docs）
curl -sS "$BASE/api/video/tasks/url" \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.bilibili.com/video/BVxxxx"}'


# 2) 轮询状态
TASK_ID=task_xxx
curl -sS "$BASE/api/video/tasks/$TASK_ID" \
  -H "Authorization: $TOKEN"


# 3) 失败重试
curl -sS "$BASE/api/video/tasks/$TASK_ID/retry" \
  -H "Authorization: $TOKEN" \
  -X POST

网盘解析

Section titled “网盘解析”
方法 路径
GET /api/cloud-drive-resolver/health
POST /api/cloud-drive-resolver/resolve
终端窗口
curl -sS "$BASE/api/cloud-drive-resolver/health"