Endpunkte

Eine App ändern

Ändern Sie eine App anhand einer Anweisung, so wie es der Editor tut.

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

Tarif: Jeder Tarif

Führt dieselbe Änderung aus wie eine Anweisung im Setherion-Editor. Es ist dieselbe Route hinter dem Eingabefeld des Editors, daher gelten dieselben Credits, dieselben Tarifregeln und dieselben Sicherheitsprüfungen, und das Ergebnis wird gespeichert und wie jede andere Änderung zum Verlauf der App hinzugefügt.

Sie müssen die App ändern dürfen: Sie gehört Ihnen, Sie sind Editor oder Admin ihres Arbeitsbereichs, oder sie wurde als Editor mit Ihnen geteilt.

Die Credits werden von dem Konto abgezogen, das für die App bezahlt. Das ist ihr Ersteller, nicht unbedingt Sie. Begrenzt der Arbeitsbereich der App, was Sie ausgeben dürfen, gilt auch dieses Limit.

Die Änderung ist gespeichert, aber erst online, wenn die App veröffentlicht ist. Rufen Sie Eine App veröffentlichen auf, wenn Sie so weit sind.

Anfrage

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" }'

Feld	Typ	Bedeutung
`prompt`	string, erforderlich	Was geändert werden soll, in jeder Sprache. Leerzeichen davor und danach werden ignoriert. Bis zu 4.000 Zeichen.
`model`	string, optional	`auto`, wenn es fehlt: Setherion wählt innerhalb Ihres Tarifs, wie im Editor. Ein KI-Modell, das Ihr Tarif nicht enthält, wird durch das beste ersetzt, das er enthält, und nicht abgelehnt.

Die App muss bereits Code haben. Eine App, die nie erstellt wurde, antwortet mit 409.

Die Antwort kommt, wenn die Änderung fertig ist

Eine Änderung dauert von einer bis zu mehreren Minuten, und die Anfrage bleibt offen, bis sie abgeschlossen ist. Eine Änderung, die länger als etwa 13 Minuten läuft, wird vom Server abgebrochen.

Während sie arbeitet, sendet Setherion alle 10 Sekunden ein Leerzeichen, damit nichts zwischen Ihnen und uns eine stille Verbindung schließt. Leerzeichen vor JSON sind weiterhin gültiges JSON: Lesen Sie den gesamten Body und parsen Sie ihn dann.

Sobald die Änderung begonnen hat, lautet der Status 200, was auch geschieht, und ok sagt, wie es gelaufen ist. Der Header X-Setherion-Run der Antwort trägt die runId der Änderung vom ersten Moment an, noch vor dem Body.

Das Schließen der Verbindung stoppt die Änderung nicht

Gibt Ihr Client auf oder bricht die Verbindung ab, läuft die Änderung weiter und landet in der App, als hätten Sie gewartet, und ihre Credits sind ausgegeben. Behalten Sie den Header X-Setherion-Run und fragen Sie mit Eine Änderung verfolgen nach, wo die Änderung steht. Um eine Änderung unterwegs zu stoppen, klicken Sie im Setherion-Editor auf Stop, auf der Karte, die sie als laufend zeigt.

Antwort

Eine abgeschlossene Änderung:

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": []
  }
}

Feld	Typ	Bedeutung
`ok`	boolean	`true`, wenn die Änderung abgeschlossen und gespeichert wurde.
`runId`	string	Die ID der Änderung. Fehlt, wenn Setherion sie nicht ermitteln konnte.
`projectId`	string	Die App, die sie geändert hat. Fehlt, wenn Setherion sie nicht ermitteln konnte.
`changed`	object	Die Dateien, die die Änderung hinzugefügt, geändert und entfernt hat, jeweils eine sortierte Liste von Pfaden. Fehlt, wenn Setherion es nicht ermitteln konnte, was nicht dasselbe ist wie „nichts hat sich geändert“.
`builds`	`false`	Nur vorhanden, wenn die geänderte App nicht mehr gebaut werden kann. Die Änderung wurde geschrieben, und ihre Credits kommen zurück. Sein Fehlen ist kein Versprechen, dass die App gebaut werden kann.
`refundedCredits`	number	Wie viele Credits zurückgekommen sind, wenn welche zurückkamen.

Eine Änderung, die den Build der App kaputt gemacht hat:

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
}

Eine Änderung, die nicht stattgefunden hat:

json

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

outOfCredits ist vorhanden und true nur dann, wenn das Konto, das für die Änderung bezahlt, keine Credits mehr hat. Jede andere Ablehnung hat ok: false und ein error und sonst nichts.

Warum eine Änderung mit ok: false antworten kann

Diese kommen mit dem Status 200 zurück, weil die Änderung begonnen hatte.

This edit costs 10 credits and you have 3. mit outOfCredits: true. Die Zahl ist der Preis dieser Änderung und Ihr Guthaben. Bei der App einer anderen Person lautet der Satz This app's owner has no credits left this month, so this edit cannot run. und nennt nie deren Guthaben.
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. mit outOfCredits: true, wenn der Inhaber eines Arbeitsbereichs begrenzt hat, was Sie ausgeben dürfen.
You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes. Änderungen und Builds sind pro Konto auf 120 pro Stunde begrenzt.
The edit stopped before it finished. Nothing was charged for it. Der Lauf endete, ohne fertig zu werden.
The edit could not start. oder The edit failed: ..., wenn auf unserer Seite etwas fehlgeschlagen ist. Versuchen Sie es erneut.

Eine Änderung verfolgen

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

Tarif: Jeder Tarif

Wo eine Änderung steht, für einen Client, der nicht mehr gewartet hat oder nie gewartet hat. Kostenlos, und Sie können etwa jede Minute gefahrlos nachfragen.

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`	Bedeutung
`running`	`true`	Arbeitet noch. Fragen Sie in etwa einer Minute erneut nach.
`done`	`true`	Abgeschlossen und in der App gespeichert. Veröffentlichen Sie sie, wenn Sie so weit sind. Mit `cutShort: true` wurde sie gespeichert, sobald der Code geschrieben war, ohne den letzten Feinschliff.
`stopped`	`false`	Gestoppt, bevor sie fertig wurde. In der App hat sich nichts geändert.
`failed`	`false`	Fehlgeschlagen. In der App hat sich nichts geändert.
`stalled`	`false`	Hat sich mehrere Minuten nicht bewegt und ist wahrscheinlich stehen geblieben. Öffnen Sie die App in Setherion, um zu sehen, wie weit sie kam.

Ein false trägt außerdem einen error-Satz, und die Änderung kann erneut gesendet werden. Diese Antwort listet die geänderten Dateien nicht auf: Das tut nur die eigene Antwort der Änderung.

Status	`error`
`400`	`Say which edit, in "run": the runId its POST answered.`
`404`	`No such app on this account.` oder `No such edit on this app.`

Fehler, bevor die Änderung beginnt

Status	Wann
`400`	`prompt` fehlt, ist leer oder länger als 4.000 Zeichen.
`401`	Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
`404`	Es gibt keine solche App, oder Ihr Schlüssel kann sie nicht ändern. Das schließt eine App ein, die Sie nur ansehen können.
`409`	Die App hat noch keinen Code. Erstellen Sie sie zuerst in Setherion.

Die genauen Sätze

Status	`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.`

War diese Seite hilfreich?

Zurück

Ihre Apps auflisten

Weiter

Eine App veröffentlichen

Der Community beitreten

Fragen, Ideen und was andere erstellen.