参考
错误与限制
每个状态码的含义、确切的提示语，以及你可以做多少。
错误的格式
每个响应都有一个 ok 字段。请求被拒绝时，ok 为 false，error 是一句话，说明出了什么问题以及该怎么办。这句话可以原样展示给用户看。
json
{ "ok": false, "error": "No such app on this account." }拒绝响应没有其他字段，只有一个例外：已经开始、后来因积分不足而无法运行的修改，还会带有 outOfCredits: true。
状态码
| 状态码 | 含义 | 该怎么做 |
|---|---|---|
200 | 完成。对于修改，表示已经开始，结果如何由 ok 告诉你。 | 读取 ok。 |
400 | 请求中缺少某些内容，或有不允许的内容。 | 根据 error 修正请求。 |
401 | 密钥缺失、错误或已被撤销。 | 检查 Authorization 请求头和密钥。 |
402 | 这个调用要花积分，但无法花：套餐不包含它，或积分不足。 | 按 error 所说，升级套餐或增加积分。 |
404 | 没有这个应用，或者你的密钥在这个调用所需的级别上无权使用它。 | 用列出你的应用检查 ID。 |
409 | 应用还没有代码，或者在发布时它的地址无法使用。 | 先在 Setherion 中构建它，或者读一下 error。 |
429 | 达到了某项限制。 | 等待它重置。 |
500 | 我们这边出了问题。 | 再试一次。 |
502 | 发布在我们这边失败了。 | 再试一次。 |
503 | Setherion 的某个部分暂时不可用。 | 一分钟后再试。 |
出于隐私考虑，“没有这个应用”和“你无权使用的应用”返回同样的 404。否则，别人可以用一个密钥来探查哪些应用存在。这也包括你只能查看、而调用需要编辑者权限的应用。
谁能做什么
你在应用中的角色决定哪些调用可用：
| 角色 | 读取（列表、上架准备指南、隐私问卷的回答） | 修改并花费积分（修改、发布、商店页面） |
|---|---|---|
| 查看者 | 可以 | 不可以，返回 404 |
| 编辑者 | 可以 | 可以 |
| 管理员、所有者 | 可以 | 可以 |
限制
| 项目 | 限制 |
|---|---|
| 有效的 API 密钥 | 每个账户 10 个 |
| 通过 API 发布 | 每个账户每天 100 次 |
| 修改与构建 | 每个账户每小时 120 次 |
| 撰写的商店页面 | 与账户的小型 AI 操作一起计数，每小时 600 次 |
| 一条修改指令的长度 | 4,000 个字符 |
一次搜索（q）的长度 | 100 个字符 |
| 一次列表返回的应用 | 每页 100 个，最近更改的排在最前。下一页请见列出你的应用。 |
| 一次修改可以花的时间 | 最长约 13 分钟 |
| 一个商店页面可以花的时间 | 最长约 2 分钟 |
每小时的限制是一种节奏，不是配额。它们是为运行速度超过人工的脚本而设的，手动操作的人永远不会碰到。实际上限制你的是积分。
修改还受你的积分和套餐限制，与编辑器中完全一样。修改因此无法运行时，返回 200，ok: false，并带有说明原因的 error。商店页面则不同：它被拒绝时还没有开始，所以返回 402。
哪种限制如何响应
- Publish 在当天的 100 次用完时返回
429，在限流器本身无法访问时返回503。 - 商店页面 在达到每小时限制时返回
429，在限流器无法访问时返回503，因套餐和积分的问题返回402。 - 修改 返回
200和ok: false，error中带有那句话。每小时限制的那句是You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.
每个调用都可能返回的提示语
| 状态码 | error |
|---|---|
401 | A valid API key is required. Make one on your Setherion account page and send it as "Authorization: Bearer sth_...". |
404 | No such app on this account. |
500 | The API is not configured on this server. |
每个调用各自的提示语
- 列出你的应用：
q is at most 100 characters.offset is a whole number, 0 or more.Could not list your apps. - 修改应用：
Say what to change, in "prompt".Keep "prompt" under 4,000 characters.This app has no code yet. Build it in Setherion first, then edit it here. - 发布应用：
That is 100 publishes through the API today. The count resets tomorrow.Publishing is briefly unavailable. Try again in a minute.Publishing through the API is not configured on this server.以及它的页面上列出的关于机密、地址、私有应用和构建的提示语。 - 上架准备指南和商店隐私问卷的回答：
way is "easy" or "native".This app has no code yet. Build it in Setherion first. - 撰写商店页面：
Writing the store page is part of the Pro plan.Too many AI actions in the last hour. Try again later.以及它的页面上列出的关于积分的提示语。
这个页面对你有帮助吗？