开源项目 · MIT许可证

NotionAI API 接口 简易集成

一个简易的页面 NotionAI API 接口 + 简易的 token 校验。 基于 notionai-py 开源项目,提供便捷的 API 封装。

核心特性

简单易用的 NotionAI API 封装,支持多种 AI 写作功能

上下文连写

基于 prompt_type 参数,根据提示和上下文内容进行智能连写,支持多种写作场景。

语调调整

使用 tone 参数智能调整文本语调,支持专业、随意、正式等多种写作风格。

主题创作

通过 topic 参数实现主题式内容生成,只需提示即可生成完整文章内容。

智能翻译

强大的多语言翻译功能,保持原文语义的同时实现自然的语言转换。

Token 校验

内置 access_token 校验机制,确保 API 调用的安全性和权限管理。

Gradio UI

提供直观的 Web 界面,无需编程即可体验 NotionAI 的强大功能。

如何使用

简单三步,快速集成 NotionAI API

1

配置环境

复制 config-dev.json 为 config.json,填写您的 access_token 和相关配置参数。

cp config-dev.json config.json
2

安装依赖

使用 pip 安装项目依赖,或使用 Docker 快速部署。

pip install -r requirements.txt
3

启动服务

运行 Uvicorn 服务器,即可通过 API 调用 NotionAI 功能。

uvicorn run main:app --reload

API 接口文档

简单易用的 RESTful API 接口

POST

/ai/notion

接口访问

默认端口:8000

请求参数说明

【注意】参数 topicprompt_typetranslatetone 不能同时为空

model

模型选择(openai-3 / openai-4)

prompt

提示内容(与 context 不能同时为空)

context

上下文内容(部分类型必选)

prompt_type

上下文连写类型

tone

语调调整参数

topic

主题书写参数

translate

翻译目标语言

notion_token

Notion token_v2 值(必选)

space_id

Notion space_id 值(必选)

api_url

代理 API URL(可选)

常见问题

快速了解项目使用中的常见问题

如何获取 Notion token 和 space_id?

Notion token 和 space_id 可以通过浏览器开发者工具从 Notion 网页版中获取。具体步骤请参考项目文档中的详细说明。

支持哪些 AI 模型?

目前支持 OpenAI-3 和 OpenAI-4 模型。您可以通过配置文件的 model 参数进行选择,API 调用时的参数优先级高于系统配置。

如何进行接口调试?

配置 http-client.env.json 后,可以在 test_main.http 中进行接口调试。access_token 的值需要与 config.json 中保持一致。

如何使用 Gradio 界面?

项目提供了基于 Gradio 的 Web 界面,可以直观体验 NotionAI 的各项功能。具体使用方法请参考 gradio_ui/README.md 文档。

技术交流

加入我们的社区,与其他开发者交流经验