Manche Werkzeuge nehmen IDs als Eingabe: eine Stimme, einen Avatar, einen Musiktitel. Diese erhalten Sie mit den Anfragen auf dieser Seite. Alle sind kostenlose GET.
Stimmen
GET /voices - jeder Schlüssel. Sprecherstimmen für POST /video/create, POST /avatar/video und das Content-Paket (form.voiceId).
curl "https://developers.grem.capital/api/v1/voices?language=de" \
-H "Authorization: Bearer gsk_live_xxx"
language (optional) - ein ISO-639-1-Code: lässt die Stimmen übrig, die diese Sprache sprechen.
| Feld | Beschreibung |
|---|---|
items[].voiceId | ID für das Feld voiceId |
items[].name | Name der Stimme |
items[].gender | male oder female |
items[].description | Charakter der Stimme |
items[].languages | Sprachen, die die Stimme gut spricht |
items[].isDefault | die Standardstimme |
Avatare
GET /avatar/avatars - Bereich tools:avatar. Alle Avatare, die Ihr Konto in POST /avatar/video nutzen kann: eigene, fotobasierte und die Standardmoderatoren.
| Feld | Beschreibung |
|---|---|
items[].avatarId | ID für das Feld avatarId |
items[].name | Name |
items[].kind | custom (trainiert), photo (aus einem Foto) oder standard |
items[].status | nur ready ist nutzbar |
items[].gender | bei Standardmoderatoren |
items[].thumbnailUrl | Vorschaubild |
Einen eigenen Avatar erstellen Sie im Kabinett, im Werkzeug KI-Avatar; über die API nutzen Sie nur fertige.
Musik für Videos
GET /video/music - Bereich tools:video. Lizenzfreie Titel für das Feld musicTrackId.
| Feld | Beschreibung |
|---|---|
items[].trackId | Titel-ID |
items[].title, items[].artist | Titel und Interpret |
items[].license | Lizenz |
items[].genre | Genre |
items[].durationSec | Dauer |
items[].previewPath | anhören: https://developers.grem.capital/api/v1 + previewPath (braucht den Bereich tools:artifacts) |
Schlusssätze für Videos
GET /video/endings?language=de - Bereich tools:video. Fertige Schlusssätze in der Videosprache für POST /video/create sowie die Höchstlänge eines eigenen Satzes (ctaText).
| Feld | Beschreibung |
|---|---|
language | Sprache der Sätze |
maxCustomChars | Höchstlänge eines eigenen Satzes |
options | fertige Sätze |
options[].intent | ID des Satzes - als ctaIntent übergeben |
options[].text | der Satz in der angefragten Sprache |
Verfügbarkeit der Werkzeuge
GET /tools/status - jeder Schlüssel.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
Ein Werkzeug mit available: false antwortet derzeit mit 503 service_unavailable und berechnet nichts. Prüfen Sie das vor einem Massenlauf. Werkzeuge, die nicht in der Liste stehen, haben keine Verfügbarkeitssperre.
Arbeitsverlauf
GET /works - jeder Schlüssel. Die Ergebnisse Ihres Kontos über alle Werkzeuge - sowohl über die API als auch aus dem Kabinett, die neuesten zuerst.
| Parameter | Beschreibung |
|---|---|
tool | Werkzeugpfad: valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Ergebnisse von Foto, Website und Entwurf werden nicht im Verlauf gespeichert |
status | Statusfilter |
limit | Einträge pro Seite, 1-50 (Standard 20) |
cursor | nextCursor der vorherigen Seite; ein anderer Wert - 400 |
from, to | angelegt an oder nach / an oder vor diesem Datum |
Ein bekannter Parameter mit ungültigem Wert wird mit 400 validation und dem Feldnamen abgelehnt.
| Feld | Beschreibung |
|---|---|
items[].id | ID des Ergebnisses |
items[].tool | Werkzeugpfad |
items[].status, items[].title, items[].language | Status, Titel, Sprache |
items[].city, items[].country | Objektadresse, falls vorhanden |
items[].street, items[].streetNumber | Straße und Hausnummer, falls vorhanden |
items[].previewUrl, items[].link | Vorschaubild und fertiges PDF, falls vorhanden (Download über GET /artifacts/{path}); die Vorschau eines Flyers ist das Bild selbst (data:image/...) |
items[].object | das Objekt, für das das Ergebnis erstellt wurde: id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | wie oft neu erzeugt wurde; ein allgemeiner Text, wenn der Auftrag fehlschlug |
items[].createdAt | erstellt am |
nextCursor | für die nächste Seite; null - keine weiteren Seiten |