エンドポイント

アプリを編集する

エディタと同じように、指示にもとづいてアプリを変更します。

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

プラン：すべてのプラン

Setherionエディタで指示を書いたときと同じ編集を実行します。エディタの入力欄の裏にあるのと同じ経路なので、同じクレジット、同じプランのルール、同じ安全チェックが適用され、結果は保存されて、ほかの編集と同じようにアプリの履歴に追加されます。

アプリを編集できる必要があります。あなたのアプリであるか、そのワークスペースのEditorまたは管理者であるか、Editorとして共有されている場合です。

クレジットは、アプリの費用を負担するアカウントから引かれます。これはアプリの作成者であり、あなたとは限りません。アプリのワークスペースがあなたの使える額に上限を設けている場合は、その上限も適用されます。

変更は保存されますが、アプリを公開するまではオンラインになりません。準備ができたらアプリを公開するを呼び出してください。

リクエスト

bash

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/edit \
  -H "Authorization: Bearer $SETHERION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Make the buttons green and add an opening hours section" }'

フィールド	型	意味
`prompt`	string、必須	何を変えるかを、どの言語でも書けます。前後の空白は無視されます。4,000文字までです。
`model`	string、任意	省略すると`auto`になり、エディタと同じように、Setherionがプランの範囲で選びます。プランに含まれないモデルは、拒否されるのではなく、含まれるモデルのうち最も良いものに置き換えられます。

アプリには、すでにコードがある必要があります。一度も作られていないアプリには409が返ります。

編集が終わると応答します

編集には1分から数分かかり、終わるまでリクエストは開いたままです。約13分を超える編集は、サーバーによって打ち切られます。

処理中、Setherionは10秒ごとに空白を送ります。これは、間にあるどこかが静かな接続を閉じないようにするためです。JSONの前にある空白も有効なJSONなので、本文を最後まで読んでから解析してください。

編集が始まった後は、何が起きてもステータスは200で、okが結果を示します。応答のX-Setherion-Runヘッダーには、本文より前の最初の時点から、その編集のrunIdが入っています。

接続を閉じても編集は止まりません

クライアントが待つのをやめたり、接続が切れたりしても、編集は続行され、待っていた場合と同じようにアプリに反映され、クレジットも使われます。X-Setherion-Runヘッダーを控えておき、編集の進行を確認するで編集の状況を尋ねてください。編集を途中で止めるには、Setherionエディタで、実行中を示すカードのStopを押します。

応答

完了した編集です。

json

{
  "ok": true,
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "changed": {
    "added": ["src/components/OpeningHours.tsx"],
    "modified": ["src/App.tsx", "src/index.css"],
    "removed": []
  }
}

フィールド	型	意味
`ok`	boolean	編集が完了して保存されたときに`true`になります。
`runId`	string	編集のIDです。Setherionが判断できなかった場合は省かれます。
`projectId`	string	変更されたアプリです。Setherionが判断できなかった場合は省かれます。
`changed`	object	編集が追加、変更、削除したファイルです。それぞれ、並べ替えたパスの一覧です。Setherionが判断できなかった場合は省かれます。これは何も変わらなかったという意味ではありません。
`builds`	`false`	編集したアプリがビルドできなくなったときにだけ付きます。編集は書き込まれましたが、そのクレジットは返却されます。付いていないことは、アプリがビルドできるという保証ではありません。
`refundedCredits`	number	クレジットが返却された場合の、返却された数です。

アプリのビルドを壊した編集です。

json

{
  "ok": true,
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "changed": { "added": [], "modified": ["src/App.tsx"], "removed": [] },
  "builds": false,
  "refundedCredits": 10
}

実行されなかった編集です。

json

{ "ok": false, "error": "This edit costs 10 credits and you have 3.", "outOfCredits": true }

outOfCreditsが付いてtrueになるのは、編集の費用を負担するアカウントのクレジットが残っていないときだけです。それ以外の拒否は、ok: falseとerrorだけを持ち、ほかには何も付きません。

編集が「ok: false」で応答する理由

これらは、編集がすでに始まっているため、ステータス200で返ります。

This edit costs 10 credits and you have 3.とoutOfCredits: true。数字は、その編集の料金とあなたの残高です。他の人のアプリでは、文はThis app's owner has no credits left this month, so this edit cannot run.になり、その人の残高は決して示されません。
You have used 40 of the 100 credits a month this workspace allows you on its owner's plan. Ask an admin to raise it.とoutOfCredits: true。ワークスペースのオーナーがあなたの使える額に上限を設けている場合です。
You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.編集とビルドは、1アカウントにつき1時間に120回までのペースに制限されます。
The edit stopped before it finished. Nothing was charged for it.実行が完了せずに終わりました。
The edit could not start.またはThe edit failed: ...。こちら側で何かが失敗したときです。もう一度試してください。

編集の進行を確認する

GEThttps://www.setherion.com/api/v1/projects/{id}/edit?run={runId}

プラン：すべてのプラン

待つのをやめた、あるいは最初から待たなかったクライアントのために、編集がどこまで進んでいるかを返します。無料で、1分ほどごとに尋ねても問題ありません。

bash

curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/edit?run=b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

json

{
  "ok": true,
  "status": "done",
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "startedAt": "2026-10-16T15:13:02.118Z"
}

`status`	`ok`	意味
`running`	`true`	処理中です。1分ほどしてから、もう一度尋ねてください。
`done`	`true`	完了し、アプリに保存されました。準備ができたら公開してください。`cutShort: true`が付いている場合は、コードが書き終わった時点で、仕上げの処理なしに保存されました。
`stopped`	`false`	完了する前に止まりました。アプリには何も変更されていません。
`failed`	`false`	失敗しました。アプリには何も変更されていません。
`stalled`	`false`	数分間動いておらず、おそらく止まっています。Setherionでアプリを開いて、どこまで進んだかを確認してください。

falseのものには、errorの文も付きます。その編集は、もう一度送ってもかまいません。この応答には、変更されたファイルの一覧は含まれません。それが載るのは、編集自身の応答だけです。

ステータス	`error`
`400`	`Say which edit, in "run": the runId its POST answered.`
`404`	`No such app on this account.`または`No such edit on this app.`

編集が始まる前のエラー

ステータス	発生する場合
`400`	`prompt`がない、空、または4,000文字を超えています。
`401`	キーがない、誤っている、または取り消されています。
`404`	そのようなアプリがないか、お使いのキーでは編集できません。閲覧しかできないアプリも含まれます。
`409`	アプリにまだコードがありません。先にSetherionで作ってください。

正確な文言

ステータス	`error`
`400`	`Say what to change, in "prompt".`
`400`	`Keep "prompt" under 4,000 characters.`
`404`	`No such app on this account.`
`409`	`This app has no code yet. Build it in Setherion first, then edit it here.`

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

アプリの一覧を取得する

アプリを公開する

コミュニティに参加

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