Certains outils prennent des identifiants en entrée : une voix, un avatar, un morceau. Vous les obtenez avec les requêtes de cette page. Ce sont toutes des requêtes GET gratuites.
Voix
GET /voices - toute clé. Voix de narration pour POST /video/create, POST /avatar/video et le pack de contenu (form.voiceId).
curl "https://developers.grem.capital/api/v1/voices?language=de" \
-H "Authorization: Bearer gsk_live_xxx"
language (facultatif) - un code ISO 639-1 : ne garde que les voix qui parlent cette langue.
| Champ | Description |
|---|---|
items[].voiceId | identifiant pour le champ voiceId |
items[].name | nom de la voix |
items[].gender | male ou female |
items[].description | caractère de la voix |
items[].languages | langues que la voix parle bien |
items[].isDefault | la voix par défaut |
Avatars
GET /avatar/avatars - scope tools:avatar. Tous les avatars que votre compte peut utiliser dans POST /avatar/video : les vôtres, ceux créés à partir d'une photo et les présentateurs standard.
| Champ | Description |
|---|---|
items[].avatarId | identifiant pour le champ avatarId |
items[].name | nom |
items[].kind | custom (entraîné), photo (à partir d'une photo) ou standard |
items[].status | seul ready peut être utilisé |
items[].gender | pour les présentateurs standard |
items[].thumbnailUrl | miniature |
Vous créez votre propre avatar dans l'espace personnel, avec l'outil Avatar IA ; via l'API, vous utilisez uniquement des avatars prêts.
Musique pour les vidéos
GET /video/music - scope tools:video. Morceaux libres de droits pour le champ musicTrackId.
| Champ | Description |
|---|---|
items[].trackId | identifiant du morceau |
items[].title, items[].artist | titre et artiste |
items[].license | licence |
items[].genre | genre |
items[].durationSec | durée |
items[].previewPath | écoute : https://developers.grem.capital/api/v1 + previewPath (nécessite le scope tools:artifacts) |
Phrases de conclusion pour les vidéos
GET /video/endings?language=en - scope tools:video. Phrases de conclusion prêtes, dans la langue de la vidéo, pour POST /video/create, et longueur maximale de votre propre phrase (ctaText).
| Champ | Description |
|---|---|
language | langue des phrases |
maxCustomChars | longueur maximale de votre propre phrase |
options | phrases prêtes |
options[].intent | identifiant de la phrase - à passer dans ctaIntent |
options[].text | la phrase dans la langue demandée |
Disponibilité des outils
GET /tools/status - toute clé.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
Un outil avec available: false répond actuellement 503 service_unavailable et ne facture rien. Vérifiez-le avant un traitement en masse. Les outils absents de la liste n'ont pas de contrôle de disponibilité.
Historique des travaux
GET /works - toute clé. Les résultats de votre compte pour tous les outils - via l'API comme depuis l'espace personnel, du plus récent au plus ancien.
| Paramètre | Description |
|---|---|
tool | chemin de l'outil : valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Les résultats de photo, de site et de brouillon ne sont pas conservés dans l'historique |
status | filtre par statut |
limit | éléments par page, 1-50 (20 par défaut) |
cursor | nextCursor de la page précédente ; toute autre valeur - 400 |
from, to | créés à cette date ou après / à cette date ou avant |
Un paramètre connu avec une valeur invalide est refusé avec 400 validation qui nomme le champ.
| Champ | Description |
|---|---|
items[].id | identifiant du travail |
items[].tool | chemin de l'outil |
items[].status, items[].title, items[].language | statut, titre, langue |
items[].city, items[].country | adresse du bien, le cas échéant |
items[].street, items[].streetNumber | rue et numéro, le cas échéant |
items[].previewUrl, items[].link | image d'aperçu et PDF final, le cas échéant (téléchargement via GET /artifacts/{path}) ; l'aperçu d'un flyer est l'image elle-même (data:image/...) |
items[].object | le bien pour lequel le résultat a été produit : id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | nombre de régénérations ; un texte générique lorsque la tâche a échoué |
items[].createdAt | date de création |
nextCursor | pour la page suivante ; null - plus de pages |