# iPhone 快捷指令 (https://21notion.com/docs/advance-feature/iPhone-Shortcut)

import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';

{/*
  [IN]: Notion API, iOS Shortcuts App
  [OUT]: iOS Shortcuts configuration guide
  [POS]: Advance feature documentation for mobile productivity
  Protocol: 更新本文件时，同步更新此头注释及所属文件夹的 .folder.md
  */}

## 说明

1. 本页面中列举的所有快捷指令暂时仅支持 iPhone
2. 目前快捷指令仅对【专业版】和【进阶版】用户开放

> **2026 更新**：Notion 已在移动端上线了[官方语音输入功能](/notion-updates/mobile-voice-input)，可以直接在 App 里语音转文字。本页的快捷指令方案依然有独特优势——支持 AI 整理和自定义写入目标数据库。

## 语音速记快捷指令

### 效果演示

首先在 iPhone 上激活快捷指令，然后直接用语音说出想要记录的内容

![iPhone 快捷指令激活时语音录制界面](https://pic.eryinote.com/PicGo/202601111711201.png)

这个快捷指令会自动进行以下操作：

1. 将语音转录为文本
2. 将文本用 DeepSeek API 进行 AI 处理，根据语义添加恰当的标点符号
3. 将步骤 2 的文本存储到 Notion 的数据库中

语音笔记效果如下

![Notion 速记数据库中转录的语音笔记列表](https://pic.eryinote.com/PicGo/202601111712195.webp)

接下来稍微进阶一点。

既然我们已经将语音以文本的形式存储到了 Notion 的数据库中，那么基于数据库的强大功能，我们就可以用数据库按钮，将当前语音笔记一键转化为正式的笔记，或者将其快速转化为一个任务。

![Notion 数据库速记按钮菜单显示转为任务和转为笔记选项](https://pic.eryinote.com/PicGo/202601111712791.png)

我可以创建一个「转为任务」的按钮，它的操作逻辑如下图所示：

![数据库转为任务按钮的逻辑配置流程](https://pic.eryinote.com/PicGo/202601111713037.png)

点击这个按钮，它会执行一下流程：

1. 在你的任务数据库中创建一个新的页面
2. 将快捷指令转录的文本存储到任务的备注字段
3. 打开这个新建的任务页面

![从语音笔记创建的任务页面完整视图](https://pic.eryinote.com/PicGo/202601111713406.png)

讲完了效果和逻辑，接下来教你如何部署自己的快捷指令。

### 配置教程

### 一、获取 Notion 数据库 ID

1. 找到 FLOW 模板的 [速记数据库](/docs/basic-feature/note-taking#quick-note-logic)
2. 确认当前字段的名称是不是【速记内容】，如果是【笔记内容】的话，请改成【速记内容】
3. 进入源数据库中，如下图所示

![Notion 速记数据库右键菜单显示打开源数据库操作](https://pic.eryinote.com/PicGo/202601111715167.png)

1. 使用快捷键 Ctrl+L（或者 CMD+L） 获取数据库链接。
2. 这个链接的格式一般是这样的：`https://www.notion.so/yourworkspace/xxxxxxxxxxxxxxxxxxxxx?v=...`
3. 获取**问号之前**的这串代码 xxxxxxxxxxxxxxxxxxxxxx ，它就是这个数据库的 ID
4. 保存好这个数据库 ID，等下有用

### 二、创建 Notion 账号密钥

1. 访问 [Notion Integration](https://www.notion.so/profile/integrations)，登录自己的 Notion 账号
2. 创建一个新的集成，可以自定义名称，关联到你的 Notion 空间，然后点击右下角保存按钮

![Notion 新建集成页面选择工作空间和命名集成](https://pic.eryinote.com/PicGo/202601111715006.png)

1. 点击「配置集成设置」，获取「内部集成密钥」

点击显示按钮，就可以复制这串密钥。记得保存好这个密钥，等下有用。

密钥格式类似：`ntn_b386784XXXXXXXXXXXXXXXXXX`

![iPhone 快捷指令配置输入 Notion 内部集成密钥](https://pic.eryinote.com/PicGo/202601111715691.png)

2. 将这个集成关联到速记数据库上

如下图所示，重新进入到速记数据库的**源数据库**

![Notion 速记数据库右键菜单再次显示打开源数据库](https://pic.eryinote.com/PicGo/202601111716806.png)

然后按照下图所示，将你创建的【集成】关联到这个源数据库上

![Notion 页面权限设置菜单关联集成到源数据库](https://pic.eryinote.com/PicGo/202601111716411.png)

### 三、申请硅基流动 API

具体教程见这篇文章：《[DeepSeek R1 薅羊毛教程](https://eryinote.com/post/1749)》。

在这一步中，你应该获得以下两个东西：

1. 硅基流动的 API，格式类似：`sk-ddguwXXXXXXXXX`
2. 你想要设置的模型名称，格式类似：`deepseek-ai/DeepSeek-V3` 这一步的模型名称可以自由挑选，不一定非得是 DeepSeek， 但**不要用 R1 之类的推理模型**

> **⚠️ 重要提醒**：申请到 API Key 后，请务必确认你的硅基流动账户里**有余额**（哪怕只充 1 块钱也行）。免费赠送的额度可能不支持快捷指令所需的 API 调用，很多用户遇到的「运行失败」都是因为这个原因。

保存好这两个东西，后面的步骤需要用到。

### 四、获取并配置你的快捷指令

1. 保存我已经创建好的 iPhone 快捷指令模板，目前仅面向【专业版】&【进阶版】用户开放，请在【飞书群公告】或者【Discord 相关频道】获取快捷指令链接
2. 按照快捷指令里的提示，修改下图四个地方的参数，请替换「`在这里输入 XXXXX`」这串文字，不要修改其他任何地方的内容

![iPhone 快捷指令参数配置说明四个输入框位置](https://pic.eryinote.com/PicGo/202601111717839.png)

图中需要配置的 4 个参数在前面的步骤中都已经准备好了，你只需要依次填写即可。请注意，你需要先删掉我的备注信息，然后再在方框内填写你的个人信息。

如果填写无误，接下来你就可以激活这个快捷指令，然后用语音的方式来记录笔记了。

## 常见问题

<Accordions>
  <Accordion id="shortcut-duration" title="Notion 语音速记模版最长能记录多长时间？">
    **建议记录在 1 分钟以内。**

    由于转录过程不仅涉及 Notion，还涉及与 AI 大模型的交互，记录时间过长可能会导致转录失败或出现意外。

    **注意：**

    * 语音速记仅适合用来快速记录简短的、零散的想法或灵感。
    * **不适合**做会议记录等需要长时间记录的场景
    * 如果你需要会议记录功能，建议订阅 Notion Business 方案，它自带 AI Meeting 语音会议记录功能，体验更佳。
  </Accordion>

  <Accordion id="shortcut-failed" title="为什么快捷指令配置失败，如何解决？">
    请按照以下步骤逐一排查：

    1. **检查基本信息**：请严格按照流程，确保每一步填写的 ID、Token、模型名称都完全正确。
    2. **检查数据库关联**：检查一下是否有将创建的 Integration（集成）关联到对应的数据库。
    3. **检查 API 配置与余额**：
       * 确保使用的硅基流动模型名称填写正确。
       * **不要使用 R1** 之类的推理模型，可以先用这个模型试试：Pro/deepseek-ai/DeepSeek-V3
       * 确保您的硅基流动账户有一定的余额（**不是免费赠送的额度**，因为赠送额度可能不支持某些模型或 API 权限）。

    **最常见的报错**：如果运行快捷指令后提示 `https://api.siliconflow.cn/v1/chat/completions` 请求失败，或者结果显示「失败」，**90% 都是因为硅基流动账户里没有余额**。请登录硅基流动后台充值后再试。
  </Accordion>
</Accordions>