端点

撰写商店页面

根据应用界面上的文字，为 Google Play 和 App Store 撰写商店页面的文字。

POSThttps://www.setherion.com/api/v1/projects/{id}/store/listing

套餐： Pro and up

一次性为两个商店写好应用商店页面的文字：名称、Google Play 的简短描述和完整描述，以及 App Store 的副标题、关键词和宣传文字。这和“Publish to app stores”窗口里的 Write it 按钮是同一项工作，套餐规则、价格和付费方都相同。

文字来自应用界面上的内容，使用这些界面的语言。撰写者会被告知，绝不能编造功能、价格、评分或用户数量，也不要提到应用商店或制作该应用所用的工具。

你需要有修改该应用的权限，因为这会消耗它的积分。不会保存任何内容：请把文字展示给所有者，让他复制到 Play Console 和 App Store Connect。

费用与套餐

积分。几点积分，在工作开始前扣除，从为该应用付费的账户扣。返回结果里的 charged 字段说明扣了多少。如果没有产生可用的页面，积分会退回。
套餐。为该应用付费的账户需要是 Pro 或 Business。Free 套餐调用会返回 402。
频率。与编辑器里其他小型 AI 操作相同的每小时上限，每个账户每小时 600 次。正常使用不会达到。

请求

不需要请求体。

bash

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
  -H "Authorization: Bearer $SETHERION_API_KEY"

最多需要大约两分钟。请把客户端的超时时间设为至少 2 分钟。

响应

json

{
  "ok": true,
  "language": "en",
  "charged": 2,
  "limits": {
    "name": 30,
    "googleShort": 80,
    "description": 4000,
    "appleSubtitle": 30,
    "appleKeywords": 100,
    "applePromo": 170
  },
  "texts": {
    "name": "Coffee Shop",
    "googleShort": "Order your coffee and cake ahead and skip the queue.",
    "description": "Coffee Shop is for anyone in Leeds who wants a good coffee without waiting. Browse the menu, choose what you like and collect it when it is ready.\n\n• Browse the full menu with prices\n• Order ahead for collection\n• See the opening hours\n• Find the shop on the map\n\nPick your favourite and skip the queue.",
    "appleSubtitle": "Order ahead, skip the queue",
    "appleKeywords": "coffee,cafe,order ahead,takeaway,cake,Leeds",
    "applePromo": "Your morning coffee, ready when you arrive. Open the menu, order ahead and collect it without waiting."
  }
}

字段	类型	含义
`language`	string	文字所用语言的代码，从应用的界面中读取。
`charged`	number	扣除的积分。当无法连接积分账本而放行调用时为 `0`。
`limits`	object	每个字段最多可以有多少字符。这些是商店自己规定的。
`texts`	object	文字。每个字段始终都有。

`texts` 的字段

字段	用在哪里	限制
`name`	两个商店里的应用名称	30 个字符
`googleShort`	Google Play，简短描述	80 个字符
`description`	完整描述，两个商店相同	4,000 个字符
`appleSubtitle`	App Store，副标题	30 个字符
`appleKeywords`	App Store，关键词，用逗号分隔，没有空格	100 个字符
`applePromo`	App Store，宣传文字	170 个字符

每个字段都会在完整的词处截断到限制以内，因为超过限制的字段会被商店后台拒绝，而模型数字符的能力很差。关键词也会被清理：每个只出现一次，也没有哪个重复名称里的词。完整描述是纯文本，人们能做的主要事情每行一条，每条以 • 开头。

错误

状态码	何时出现
`401`	密钥缺失、错误或已被撤销。
`402`	为该应用付费的账户是 Free 套餐，或者没有积分了，或者已达到工作区对你设置的限额。
`404`	没有这个应用，或者你的密钥无法修改它。
`409`	应用还没有代码。请先在 Setherion 中构建它。
`429`	这个账户在过去一小时内进行了超过 600 次小型 AI 操作。
`500`	撰写者的回答无法使用。不会扣费：积分会退回。请再试一次。
`503`	限流器暂时不可用，所以没有运行任何内容。请一分钟后再试。

完整的提示语句

状态码	`error`
`402`	`Writing the store page is part of the Pro plan.`
`402`	`This costs 2 credits and you have 1.`
`402`	`This app's owner has no credits left this month.`
`402`	`You have used the credits this workspace allows you this month. Ask an admin to raise your limit.`
`404`	`No such app on this account.`
`409`	`This app has no code yet. Build it in Setherion first.`
`429`	`Too many AI actions in the last hour. Try again later.`
`500`	`The model did not answer with the store page.`
`500`	`The model's answer was cut off or not readable.`
`500`	`The model left out: appleKeywords.`
`503`	`Usage limits are briefly unavailable, so this was not run. Try again in a minute.`

第一个 402 对应 Free 套餐。第二个里的数字是价格和你的余额；如果是别人的应用，你会看到第三句，它从不提到对方的余额。500 那几行是示例：语句会指出哪里出了问题，积分会退回。

这个页面对你有帮助吗？

商店隐私问卷的回答

MCP 服务器

加入社区

提问、交流想法，看看别人在构建什么。

撰写商店页面

费用与套餐

请求

响应

texts 的字段

错误

`texts` 的字段