リファレンス

エラーと制限

各ステータスコードの意味、正確なエラーメッセージ、そしてどこまで実行できるか。

エラーの形

すべてのレスポンスには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`	Setherion側で何かが失敗しました。	もう一度試してください。
`502`	Setherion側で公開に失敗しました。	もう一度試してください。
`503`	Setherionの一部が一時的に使えません。	1分後にもう一度試してください。

プライバシーのため、「そのようなアプリがない」場合と「使えないアプリ」の場合は、同じ404を返します。そうしないと、キーを使ってどのアプリが存在するかを探れてしまうからです。呼び出しに編集者が必要なとき、閲覧のみのアプリもこれに含まれます。

アプリでのあなたのロールによって、使える呼び出しが決まります。

項目	制限
有効なAPIキー	1アカウントにつき10個
APIでの公開	1アカウントにつき1日100回
編集とビルド	1アカウントにつき1時間120回
書き込まれるストアページ	アカウントの小さなAI操作と合わせて数え、1時間600回
編集の指示の長さ	4,000文字
検索（`q`）の長さ	100文字
一覧で返されるアプリ	1ページ100件、最近変更されたものから順に。次のページはアプリの一覧を取得するをご覧ください。
編集にかかる時間	最大で約13分
ストアページにかかる時間	最大で約2分

1時間あたりの制限は、許容量ではなくペースの目安です。人間より速く動くスクリプトのためにあり、手作業で使う人がこれに達することはありません。実際に上限となるのは、あなたのクレジットです。

編集は、エディタと同じように、クレジットとプランによっても制限されます。その理由で編集を実行できないときは、200でok: falseが返り、errorに理由が入ります。ストアページは違います。拒否された時点ではまだ開始されていないため、402を返します。

Publishは、1日の100回を使い切ると429を返し、制限の仕組みそのものに接続できないときは503を返します。
Store pageは、1時間の制限で429を返し、制限の仕組みに接続できないときは503、プランとクレジットの問題では402を返します。
Editは200でok: falseを返し、errorに文が入ります。1時間の制限のメッセージは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. のほか、クレジットに関するメッセージが、そのページに載っています。

このページは役に立ちましたか？

OAuthでログインする

コミュニティに参加

質問、アイデア、ほかの人が作っているもの。