Dieselben Werkzeuge, die Sie im Kabinett nutzen, stehen auch programmgesteuert bereit. Jeder Aufruf wird genauso von Ihrer Kasse bezahlt wie die Arbeit über die Oberfläche: zuerst das Abo, dann das Paket, dann die Zahlung nach Verbrauch. Leseanfragen (GET) werden nie berechnet.
Grundadresse: https://developers.grem.capital/api/v1.
Die Werkzeuge
| Aufruf | Nötiger Geltungsbereich | Wie es arbeitet |
|---|---|---|
POST /valuation/express | jeder Schlüssel | unmittelbar |
POST /valuation/report | tools:valuation | verzögert |
POST /valuation/rent | tools:rent | unmittelbar |
POST /valuation/review | tools:review | verzögert, mit Datei |
POST /content/generate | tools:contentgen | verzögert |
POST /text/generate | tools:text | verzögert |
POST /avatar/video | tools:avatar | verzögert |
POST /video/create | tools:video | verzögert, mit Datei |
POST /photo/enhance | tools:photo | verzögert, mit Datei |
POST /floorplan/create | tools:floorplan | verzögert, mit Datei |
POST /draft/extract | tools:draft | unmittelbar, mit Datei |
POST /site/create | tools:sitegen | unmittelbar, braucht ein Inserat |
POST /pdf/create | tools:pdf | verzögert, braucht ein Inserat |
Fehlt dem Schlüssel der Geltungsbereich, gibt der Aufruf 403 zurück. Die Bereiche vergeben Sie beim Anlegen des Schlüssels im Kabinett: KI-Werkzeuge → API → Schlüssel. Siehe Authentifizierung.
Unmittelbare Aufrufe
Ein unmittelbares Werkzeug gibt 200 mit dem fertigen Ergebnis im Körper der Antwort zurück:
curl -X POST https://developers.grem.capital/api/v1/valuation/rent \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"propertyCategory":"apartment","totalArea":50,"city":"Kyiv"}'
Verzögerte Aufrufe
Lange Werkzeuge (Bewertungsbericht, Texte, Foto, Video, Avatar, Grundriss, PDF) geben 202 und eine Kennung der Aufgabe zurück:
{ "jobId": "…", "status": "pending", "requestId": "req_…" }
Fragen Sie den Zustand unter GET /<Weg des Werkzeugs>/jobs/{jobId} ab:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/content/generate/jobs/JOB_ID
Die Antwort trägt das Feld status. Endzustände sind completed (oder done, success) und failed. Solange die Aufgabe läuft, wiederholen Sie die Anfrage alle paar Sekunden.
Das Abfragen ist kostenlos: Ein GET zählt nicht als API-Aufruf und wird nicht berechnet. Trotzdem ist ein Abonnement auf ein Ereignis besser als dichtes Abfragen - siehe Webhooks.
Jede Aufgabe gehört zu dem Schlüssel, der sie angelegt hat. Eine fremde jobId gibt immer 404 zurück, auch wenn es eine solche Aufgabe gibt.
Werkzeuge, die eine Datei nehmen
Aufrufe mit dem Vermerk «mit Datei» erwarten multipart/form-data: Die Optionen kommen als JSON in ein Textfeld namens data, und die Datei selbst ist ein eigener Teil.
curl -X POST https://developers.grem.capital/api/v1/photo/enhance \
-H "Authorization: Bearer gsk_live_xxx" \
-F 'data={"mode":"enhance"}' \
-F "image=@room.jpg"
Schicken Sie an einen davon einfaches JSON, kommt 400 mit dem Hinweis, dass multipart/form-data erwartet wird.
Werkzeuge, die ein Inserat brauchen
Website- und PDF-Generator bauen die Präsentation aus einem vorhandenen Inserat, der Körper der Anfrage muss also eine objectId tragen (oder eine collectionId für eine Auswahl). Das Inserat muss Ihres sein - eine fremde Kennung gibt einen Fehler des Zugriffs zurück.
curl -X POST https://developers.grem.capital/api/v1/pdf/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"objectId":"64f…","language":"en"}'
Die fertigen Dateien
Ergebnisse (PDF, Video, Bilder, Seiten) kommen als Links auf der Domain von GREM zurück. Laden Sie sie über GET /artifacts/… mit demselben Schlüssel herunter - siehe Dateien und Ergebnisse.
Wiederholen ohne Dopplung
Das Anlegen einer Aufgabe lässt sich gefahrlos wiederholen: Schicken Sie den Kopf Idempotency-Key, dann gibt eine Wiederholung mit demselben Schlüssel das ursprüngliche Ergebnis zurück, statt zweimal zu berechnen. Einzelheiten in Idempotenz.
Was die Fehler bedeuten
402- zu wenig Geld in der Kasse oder das Kontingent des Tarifs ist verbraucht.403- der Schlüssel hat für dieses Werkzeug keinen Geltungsbereich.429- die Grenze der Häufigkeit ist erreicht; wiederholen Sie nach der Pause aus dem KopfRetry-After.
Die vollständige Liste steht in Fehler.
Verwandte Artikel
- Schneller Einstieg - der erste Aufruf in fünf Minuten.
- Webhooks - das fertige Ergebnis bekommen, statt abzufragen.
- Dateien und Ergebnisse - Bilder hochladen und Artefakte herunterladen.