Docs

Schneller Einstieg

Zuletzt aktualisiert: 2026-07-212 Min. Lesezeit

Über die Developer-API von GREM rufen Sie unsere Werkzeuge programmgesteuert über HTTPS auf - Objektbewertung, Erzeugung von Inhalten, Fotoverbesserung, Video mit Avatar, Website- und PDF-Generator sowie den KI-Chat. Anfragen und Antworten sind JSON.

Grundadresse

Alle Endpunkte liegen unter dieser Adresse:

https://developers.grem.capital/api/v1

1. Einen API-Schlüssel holen

Öffnen Sie im Kabinett KI-Werkzeuge → API und legen Sie im Reiter Schlüssel einen Schlüssel an. Das Geheimnis (gsk_live_…) erscheint einmal - kopieren Sie es sofort.

Behandeln Sie den Schlüssel wie ein Passwort: Er öffnet den Zugang zu den Werkzeugen und zur Abrechnung Ihres Kontos. Legen Sie ihn niemals in die Versionsverwaltung und zeigen Sie ihn nicht im Code des Browsers.

2. Der erste Aufruf

GET /ping prüft den Schlüssel und kostet nichts:

curl -H "Authorization: Bearer gsk_live_xxx" \
  https://developers.grem.capital/api/v1/ping
{ "ok": true, "subjectId": "…", "requestId": "req_…" }

3. Ein Werkzeug aufrufen

Ein Beispiel für einen unmittelbaren Aufruf - die Express-Bewertung eines Objekts:

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","totalArea":50}'
{
  "estimate": { "pricePoint": 156250, "rangeLow": 125575, "rangeHigh": 207813, "currency": "USD" },
  "requestId": "req_…"
}

Lange Werkzeuge

Werkzeuge wie die Erzeugung von Inhalten, ein Video mit Avatar oder ein PDF geben eine Aufgabe zurück (202 mit jobId). Fragen Sie den Endpunkt des Zustands ab (das ist kostenlos) oder besser: abonnieren Sie einen Webhook, um bei Fertigstellung benachrichtigt zu werden. Erzeugte Dateien werden über unsere Domain als Artefakte ausgeliefert.

Alle Endpunkte ansehen

Interaktiver Explorer

Probieren Sie Anfragen live in Swagger UI unter https://developers.grem.capital/docs.

OpenAPI-Spezifikation

Importieren Sie https://developers.grem.capital/openapi.json in Postman oder Insomnia oder erzeugen Sie daraus einen Client.

Häufige Fragen

Wo bekomme ich einen API-Schlüssel?

Im Kabinett: KI-Werkzeuge > API, Reiter «Schlüssel». Das Geheimnis erscheint einmal - kopieren Sie es sofort.

Wie lautet die Grundadresse?

https://developers.grem.capital/api/v1

Wie prüfe ich, dass der Schlüssel arbeitet?

Rufen Sie GET /ping auf - dieser Aufruf wird nicht berechnet.

Werden Leseanfragen berechnet?

Nein. GET-Anfragen zählen nicht als API-Aufrufe und werden nicht von der Kasse abgebucht, auch nicht das Abfragen des Zustands verzögerter Aufgaben.

Was tun, wenn ein Aufruf 402 zurückgibt?

In der Kasse fehlt Geld oder das Kontingent des Tarifs ist verbraucht. Füllen Sie das Guthaben auf oder wechseln Sie in einen höheren Tarif.

War dieser Artikel hilfreich?