diff --git a/en/api-doc/record/get.mdx b/en/api-doc/record/get.mdx
index 327415e5..fde9422f 100644
--- a/en/api-doc/record/get.mdx
+++ b/en/api-doc/record/get.mdx
@@ -20,6 +20,8 @@ All parameters are optional
Specifies the number of records to retrieve, maximum value is 100. To read more records, page through the data with `skip` and `take` (see [Pagination](/en/api-doc/overview)).
+
+ The 100-record cap applies to Teable Cloud personal API keys created on or after September 10, 2026. Keys created before that date, OAuth and plugin tokens, and self-hosted instances still accept up to 1000, but pages of 100 remain the recommended size.
diff --git a/en/basic/ai/app-builder.mdx b/en/basic/ai/app-builder.mdx
index f53faaf1..6fbc03d0 100644
--- a/en/basic/ai/app-builder.mdx
+++ b/en/basic/ai/app-builder.mdx
@@ -97,7 +97,7 @@ Use **Secrets** for API keys, credentials, and configuration values your app nee
| Availability | App Secrets are available in the app preview environment and the published app |
| Code access | Server-side app code can read them from environment variables such as `process.env.MY_API_KEY` |
| Saved values | Secret values are write-only after saving; enter a new value to update one |
-| Key format | Keys must start with an uppercase letter and can contain uppercase letters, digits, and underscores |
+| Name format | The **Name** must start with an uppercase letter and can contain uppercase letters, digits, and underscores |
After you add, delete, or change a Secret value, the app preview environment uses the new value. The published app uses it only after you republish. Editing only a Secret description does not require republishing.
diff --git a/en/basic/space/billing.mdx b/en/basic/space/billing.mdx
index 54f79a28..69e145e2 100644
--- a/en/basic/space/billing.mdx
+++ b/en/basic/space/billing.mdx
@@ -29,10 +29,11 @@ Shows your current subscription status including:
- **Subscription level** (Free, Pro, or Business)
- **Price per seat** (monthly or yearly)
-- **Number of seats**
-- **Renewal date** or cancellation date if applicable
+- **Number of seats** you have purchased
+- **Renewal date**, or the cancellation date when the subscription is set to cancel
+- A plan change already scheduled for the end of the current period
-Click **Change plan** to upgrade, downgrade, or modify your subscription.
+Click **Change plan** to open the Plan page, where you can change the plan level, the number of seats, and the credit tier.
### Usage Statistics
@@ -60,16 +61,17 @@ To continue, upgrade the plan or free up room by deleting records or attachments
Credits are Teable's usage units for AI-powered features. Consumption is based on the AI tokens used by the underlying language models, and you can review the details on the Billing page. Credits reset every billing period and do not roll over.
-**Monthly credit allocation per plan:**
-- **Free**: 200 credits/month
-- **Pro**: 1,000 credits/seat/month
-- **Business**: 2,000 credits/seat/month
+On paid plans, credits are bought per seat. Each plan card carries a **credits/seat/month** tier, and the space's monthly credits are the purchased seats multiplied by that tier, shared by everyone in the space.
-**Add-on credits:** Pro and above users can purchase additional credits.
+| Plan | Monthly credits |
+|------|-----------------|
+| **Free** | 200 credits for the space |
+| **Pro** | 2,000 to 6,000 credits per seat |
+| **Business** | 3,000 to 1,000,000 credits per seat |
-When you add new billable collaborators, the seat count is updated at the start of the next billing cycle. Credits for new seats are allocated at that point on a prorated basis. If credits are needed before then, add-on credits can be purchased for instant use.
+To get more credits, buy more seats or choose a higher credit tier on the plan card. The bigger the tier, the less each credit costs.
-**What happens when credits run out:** Once your monthly credits are exhausted, AI features will be limited until the next billing cycle or until you purchase additional credits.
+**What happens when credits run out:** Once your monthly credits are exhausted, AI features will be limited until the next billing cycle or until you raise the credit tier.
Credits only apply to Teable Cloud; self-hosted editions don't consume Teable Cloud credits and are instead limited by your own infrastructure and any external AI providers you use.
@@ -108,13 +110,14 @@ The invoice table shows:
To upgrade, downgrade, or modify your plan:
1. Go to **Settings** → **Plan**
-2. Review the available plan cards: **Free**, **Pro**, and **Business**
-3. Click **Subscribe** on the plan you want
-4. Choose a billing cycle (Monthly or Yearly)
-5. Adjust the number of seats if needed
-6. Complete the checkout process
+2. Choose the billing period (Monthly or Yearly) at the top of the page
+3. On the plan card you want, pick the **credits/seat/month** tier and set the number of seats. The card shows the resulting monthly credits and the total price
+4. Click **Subscribe**, or **Modify subscription** on your current plan
+5. Complete the checkout or confirmation
-Yearly billing saves approximately 17% compared to monthly billing.
+Yearly billing is cheaper than monthly. The Plan page shows the current saving on the Yearly tab.
+
+Changing an existing subscription goes through a confirmation page in the billing portal and then returns you to the Billing page. An upgrade applies immediately and is prorated, while a downgrade is scheduled for the end of the current billing period. A scheduled change or a pending cancellation appears in a banner above the plan cards, with **Undo** to keep the subscription as it is.
### Available Plans
@@ -124,11 +127,18 @@ To upgrade, downgrade, or modify your plan:
| **Pro** | Small teams & professionals |
| **Business** | Scaling businesses |
+### Seats
+
+Seats are purchased up front, and buying ahead of your team is fine. A seat is taken by collaborators with the **Owner**, **Creator**, or **Editor** role in the space and its bases. **Commenter** and **Viewer** are free.
+
+On cloud plans the purchased seats are a hard limit. Teable blocks any action that would push the space past it and offers to add seats. This covers email invitations, creating an invite link with a billable role or switching a link to one, joining through such a link, adding collaborators directly, and promoting someone to a billable role. Someone who already holds a seat can join another base or change role without taking a new one.
+
+To continue, add seats on the Plan page, or give the person the free Commenter or Viewer role. Only the space owner can buy seats.
+
### Add-on Usage Subscriptions
In the **Plan** tab, **Add-on usage subscriptions** lets you purchase extra usage without changing the main plan. Available add-ons include:
-- **Credits**
- **Automation**
- **Records**
- **Attachments storage**
@@ -163,7 +173,7 @@ After cancellation:
Seats are counted based on collaborators with **Editor** role or higher (Owner, Creator, Editor). Collaborators with **Commenter** or **Viewer** (Read-only) roles are free of charge.
- - **Cloud version**: Teable Cloud plans are billed per seat on a space basis. Seats are counted across the space. Charges are prorated: if you add billable collaborators partway through a billing period, you only pay for the remaining time in that period.
+ - **Cloud version**: Teable Cloud plans are billed per seat on a space basis, and seats are bought up front for the whole space. Charges are prorated: if you buy seats partway through a billing period, you only pay for the remaining time in that period. Collaborators cannot exceed the purchased seats.
- **Self-hosted version**: Pricing is based on a monthly or annual pre-paid seat license with no storage, row, or other usage limits. Seats are counted across the entire instance. If the number of users exceeds your license limit, you will need to upgrade your plan to add more seats. See [License Activation](/en/deploy/activate) for details.
For Business plans with Authority Matrix enabled, users assigned through Authority Matrix are counted as billable users.
@@ -171,8 +181,12 @@ After cancellation:
Have more questions about products or pricing? [Contact sales](https://contact.teable.ai/).
-
- In a paid space, Teable asks for confirmation before an invitation or role change increases the number of subscription seats.
+
+ On cloud plans, purchased seats are a hard limit. An invitation, invite link, or role change that would need a seat you have not bought is rejected, and Teable offers to add seats. Buy seats on the Plan page, or give the person the free Commenter or Viewer role. Within the seats you already own, inviting someone costs nothing extra and needs no confirmation. Adding a member through the authority matrix still asks for confirmation, because that path bills automatically.
+
+
+
+ Yes, until it takes effect. The banner above the plan cards names the pending change and the date it applies. Click **Undo**, and the subscription keeps renewing as it is.
@@ -208,10 +222,7 @@ After cancellation:
- AI-powered features in Teable use credits. See the credit usage details on the Billing page for the specific usage. Each plan includes a monthly credit allocation:
- - **Free**: 200 credits
- - **Pro**: 1,000 credits per seat
- - **Business**: 2,000 credits per seat
+ AI-powered features in Teable use credits. See the credit usage details on the Billing page for the specific usage. Free spaces get 200 credits a month. On Pro and Business, you choose a credits/seat/month tier when you subscribe, and the space's monthly credits are that tier multiplied by the purchased seats.
@@ -247,11 +258,11 @@ After cancellation:
The notification opens **Space Settings** → **Billing**. When available, it shows the main sources of credit usage.
- If the usage is expected, consider buying extra credits or changing your plan. If it is unexpected, review the top contributor and adjust or pause the related workflow, app, or AI feature.
+ If the usage is expected, consider raising the credit tier or changing your plan. If it is unexpected, review the top contributor and adjust or pause the related workflow, app, or AI feature.
- Credits are allocated based on your billed seat count. When you add new billable collaborators, the seat count is updated at the start of the next billing cycle. Credits for new seats are allocated at that point on a prorated basis. If credits are needed before then, add-on credits can be purchased for instant use.
+ Credits follow the seats you have purchased, not the number of people using them. Filling a seat you already own changes nothing. To get more credits, buy seats or raise the credit tier on the Plan page.
diff --git a/zh/api-doc/record/get.mdx b/zh/api-doc/record/get.mdx
index 02890bfe..ff0121b9 100644
--- a/zh/api-doc/record/get.mdx
+++ b/zh/api-doc/record/get.mdx
@@ -21,6 +21,8 @@ tableId (string): 表的唯一标识符[(如何获取)](/zh/api-doc/get-id#t
指定要获取的记录数量,最大值为 100。需要读取更多数据时,请配合 `skip` 与 `take` 分页获取(见[分页说明](/zh/api-doc/overview))。
+
+ 100 条的上限适用于 2026 年 9 月 10 日及以后创建的 Teable 云版个人 API Key。此前创建的 Key、OAuth 与插件令牌,以及自托管实例仍可取到 1000 条,但仍建议按 100 条分页。
diff --git a/zh/basic/ai/app-builder.mdx b/zh/basic/ai/app-builder.mdx
index b2b18053..1b073306 100644
--- a/zh/basic/ai/app-builder.mdx
+++ b/zh/basic/ai/app-builder.mdx
@@ -105,7 +105,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下,
| 生效范围 | 应用密钥可用于应用预览环境和已发布应用 |
| 代码读取 | 服务端代码可通过 `process.env.MY_API_KEY` 等环境变量读取 |
| 已保存的值 | 保存后不会明文展示;需要修改时,输入新值覆盖 |
-| Key 格式 | Key 需要以大写字母开头,只能包含大写字母、数字和下划线 |
+| 名称格式 | **名称**需要以大写字母开头,只能包含大写字母、数字和下划线 |
新增、删除或修改密钥值后,应用预览环境会使用新值;已发布应用需要重新发布后才会使用。只修改密钥描述,不需要重新发布。
diff --git a/zh/basic/space/billing.mdx b/zh/basic/space/billing.mdx
index 654a07ca..e6e89d42 100644
--- a/zh/basic/space/billing.mdx
+++ b/zh/basic/space/billing.mdx
@@ -29,10 +29,11 @@ description: "了解如何管理订阅、查看账单详情、监控用量以及
- **订阅级别**(免费版、专业版、商业版)
- **席位单价**(月付或年付)
-- **席位数量**
-- **续费日期**或取消日期(如适用)
+- **已购席位数量**
+- **续费日期**;如果订阅已设置取消,则显示取消日期
+- 已预约在周期末生效的订阅计划变更
-点击**改变订阅计划**按钮可以升级、降级或修改订阅。
+点击**改变订阅计划**进入订阅计划页,可在其中调整订阅级别、席位数量和算力档位。
### 用量统计
@@ -60,16 +61,17 @@ description: "了解如何管理订阅、查看账单详情、监控用量以及
算力是 Teable AI 功能的使用单位。实际消耗量根据底层语言模型使用的 AI Token 计算,可在计费页查看明细。算力在每个计费周期重置,不会累积到下一周期。
-**各计划每月算力配额:**
-- **免费版**:200 算力/月(固定)
-- **专业版**:1,000 算力/席位/月
-- **商业版**:2,000 算力/席位/月
+付费计划的算力按席位购买:订阅计划卡片上可以选择**算力/席位/月**档位,空间每月的算力等于已购席位数乘以该档位,由空间成员共用。
-添加新的计费协作者后,席位数量会在下一个计费周期开始时更新。新席位的算力将按比例分配。如果在此之前需要算力,可以购买额外算力订阅以立即使用。
+| 订阅计划 | 每月算力 |
+|------|------|
+| **免费版** | 空间共 200 算力 |
+| **专业版** | 每席位 2,000 至 6,000 算力 |
+| **商业版** | 每席位 3,000 至 1,000,000 算力 |
-**购买额外算力:** 专业版及以上用户可以购买额外算力。
+需要更多算力时,可以增购席位或在卡片上选择更高的算力档位,买得越多单位算力越便宜。
-**算力用尽后会怎样:** 当月算力用尽后,AI 功能将受限,直到下一个计费周期或购买额外算力。
+**算力用尽后会怎样:** 当月算力用尽后,AI 功能将受限,直到下一个计费周期或提高算力档位。
算力仅适用于 Teable 云版本;自托管版本不消耗 Teable 云算力,而是受限于您自己的基础设施和外部 AI 服务商。
@@ -108,13 +110,14 @@ description: "了解如何管理订阅、查看账单详情、监控用量以及
要升级、降级或修改订阅计划:
1. 进入**设置** → **订阅计划**
-2. 查看可用的订阅计划卡片:**免费版**、**专业版**和**商业版**
-3. 点击目标计划上的**订阅**
-4. 选择计费周期(月付或年付)
-5. 按需调整席位数量
-6. 完成结账流程
+2. 在页面顶部选择计费周期(月付或年付)
+3. 在目标计划卡片上选择**算力/席位/月**档位,并设置席位数量。卡片会显示对应的每月算力和总价
+4. 点击**订阅**;如果是当前订阅的计划,点击**修改订阅计划**
+5. 完成结账或确认
+
+年付比月付更便宜,具体折扣以订阅计划页年付标签上的显示为准。
-年付比月付节省约 17%。
+修改已有订阅时会先进入结算门户的确认页,确认后回到计费页。升级立即生效并按比例计费,降级则安排在当前计费周期结束时生效。已预约的变更或待生效的取消会显示在订阅计划卡片上方的横幅中,点击**撤销**即可让订阅保持现状继续续费。
### 可用计划
@@ -124,11 +127,18 @@ description: "了解如何管理订阅、查看账单详情、监控用量以及
| **专业版** | 小型团队和专业用户 |
| **商业版** | 成长型企业 |
-### 附加用量订阅
+### 席位
+
+席位需要提前购买,按团队的预期规模多买一些也没问题。空间及其数据库中**所有者**、**可搭建**、**可编辑**角色的协作者会占用席位,**可评论**和**可查看**免费。
+
+在云版中,已购席位是硬性上限。超出席位的操作会被拒绝,并弹出增购席位的窗口,包括邮件邀请、创建计费角色的邀请链接或把链接改成计费角色、通过这类链接加入、直接添加协作者,以及把成员提升为计费角色。已经占用席位的成员加入其他数据库或调整角色,不会额外占用席位。
-在**订阅计划**标签页中,**附加用量订阅**可用于购买额外用量,而无需切换主订阅计划。当前支持的附加用量包括:
+要继续操作,可以在订阅计划页增购席位,或改用免费的可评论、可查看角色。只有空间所有者可以购买席位。
+
+### 额外增量订阅
+
+在**订阅计划**标签页中,**额外增量订阅**可用于购买额外用量,而无需切换主订阅计划。当前支持的额外用量包括:
-- **算力**
- **自动化**
- **记录**
- **附件容量**
@@ -163,7 +173,7 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时,您并非
席位根据具有**可编辑**及以上权限的协作者(所有者、可搭建、可编辑)计算。具有**可评论**或**可查看**(只读)权限的协作者免费,不计入席位。
- - **云版本**:Teable 云按席位计费,以空间为单位。席位按空间内的计费协作者统计。费用按比例计算:如果您在计费周期中途添加计费协作者,只需支付该周期剩余时间的费用。
+ - **云版本**:Teable 云按席位计费,以空间为单位,席位需要为整个空间提前购买。费用按比例计算:如果您在计费周期中途增购席位,只需支付该周期剩余时间的费用。协作者数量不能超过已购席位。
- **自托管版本**:基于月付或年付的预付席位许可证定价,无存储、行数或其他使用限制。席位按整个实例统计。如果用户数超过许可证限制,需要升级计划以增加席位。详见[许可证激活](/zh/deploy/activate)。
对于启用了权限矩阵的商业版本,通过权限矩阵规则分配的用户也会根据其最高授权权限影响席位计数。
@@ -171,8 +181,12 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时,您并非
对产品或价格还有疑问?[联系销售](https://contact.teable.ai/)。
-
- 在付费空间中,如果邀请或角色调整会增加订阅席位,Teable 会在操作前要求确认。
+
+ 在云版中,已购席位是硬性上限。邀请、邀请链接或角色调整需要用到尚未购买的席位时会被拒绝,Teable 会提示增购席位。你可以在订阅计划页增购席位,或改用免费的可评论、可查看角色。在已购席位范围内邀请成员不会产生额外费用,也不需要确认。通过权限矩阵添加成员仍会要求确认,因为这条路径会自动计费。
+
+
+
+ 在生效之前都可以撤销。订阅计划卡片上方的横幅会写明待生效的变更和生效日期,点击**撤销**后,订阅将保持现状继续续费。
@@ -208,10 +222,7 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时,您并非
- Teable 中由 AI 模型提供支持的功能会消耗算力,具体以计费页的算力明细为准。每个计划包含每月算力配额:
- - **免费版**:200 算力(固定)
- - **专业版**:1,000 算力/席位
- - **商业版**:2,000 算力/席位
+ Teable 中由 AI 模型提供支持的功能会消耗算力,具体以计费页的算力明细为准。免费版每月有 200 算力。专业版和商业版在订阅时选择「算力/席位/月」档位,空间每月的算力等于该档位乘以已购席位数。
@@ -247,11 +258,11 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时,您并非
通知会打开**空间设置** → **计费**。如果能识别主要来源,通知会显示主要消耗来源。
- 如果这些用量符合预期,可以考虑购买额外算力或调整订阅计划。如果用量不符合预期,请查看主要来源,并调整或暂停相关工作流、应用或 AI 功能。
+ 如果这些用量符合预期,可以考虑提高算力档位或调整订阅计划。如果用量不符合预期,请查看主要来源,并调整或暂停相关工作流、应用或 AI 功能。
-
- 算力根据已计费的席位数分配。添加新的计费协作者后,席位数量会在下一个计费周期开始时更新。新席位的算力将按比例分配。如果在此之前需要算力,可以购买额外算力订阅以立即使用。
+
+ 算力取决于已购席位数,而不是实际使用席位的人数。把人加到已经买好的席位上,算力不会变化。需要更多算力时,请在订阅计划页增购席位或提高算力档位。