Algunas herramientas toman ids como entrada: una voz, un avatar, una pista. Se obtienen con las solicitudes de esta página. Todas son GET gratuitos.
Voces
GET /voices: cualquier clave. Voces de locución para POST /video/create, POST /avatar/video y el paquete de contenido (form.voiceId).
curl "https://developers.grem.capital/api/v1/voices?language=es" \
-H "Authorization: Bearer gsk_live_xxx"
language (opcional): un código ISO 639-1; deja las voces que hablan ese idioma.
| Campo | Descripción |
|---|---|
items[].voiceId | id para el campo voiceId |
items[].name | nombre de la voz |
items[].gender | male o female |
items[].description | carácter de la voz |
items[].languages | idiomas que la voz habla bien |
items[].isDefault | la voz por defecto |
Avatares
GET /avatar/avatars: ámbito tools:avatar. Todos los avatares que su cuenta puede usar en POST /avatar/video: los propios, los creados a partir de una foto y los presentadores estándar.
| Campo | Descripción |
|---|---|
items[].avatarId | id para el campo avatarId |
items[].name | nombre |
items[].kind | custom (entrenado), photo (a partir de una foto) o standard |
items[].status | solo ready se puede usar |
items[].gender | en los presentadores estándar |
items[].thumbnailUrl | miniatura |
Su propio avatar se crea en el panel, en la herramienta de avatar con IA; por API solo se usan los que ya están listos.
Música para vídeo
GET /video/music: ámbito tools:video. Pistas libres de derechos para el campo musicTrackId.
| Campo | Descripción |
|---|---|
items[].trackId | id de la pista |
items[].title, items[].artist | título e intérprete |
items[].license | licencia |
items[].genre | género |
items[].durationSec | duración |
items[].previewPath | escuchar: https://developers.grem.capital/api/v1 + previewPath (requiere el ámbito tools:artifacts) |
Frases finales para vídeo
GET /video/endings?language=es: ámbito tools:video. Frases finales listas en el idioma del vídeo para POST /video/create, y la longitud máxima de una frase propia (ctaText).
| Campo | Descripción |
|---|---|
language | idioma de las frases |
maxCustomChars | longitud máxima de una frase propia |
options | frases listas |
options[].intent | id de la frase: páselo como ctaIntent |
options[].text | la frase en el idioma pedido |
Disponibilidad de las herramientas
GET /tools/status: cualquier clave.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
Una herramienta con available: false responde ahora 503 service_unavailable y no cobra nada. Compruébelo antes de un lanzamiento masivo. Las herramientas que no figuran en la lista no tienen control de disponibilidad.
Historial de trabajos
GET /works: cualquier clave. Los resultados de su cuenta en todas las herramientas, tanto por API como desde el panel, los más recientes primero.
| Parámetro | Descripción |
|---|---|
tool | ruta de la herramienta: valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Los resultados de foto, sitio y borrador no se guardan en el historial |
status | filtro por estado |
limit | elementos por página, 1-50 (20 por defecto) |
cursor | nextCursor de la página anterior; otro valor: 400 |
from, to | creados en esa fecha o después / en esa fecha o antes |
Un parámetro conocido con un valor no válido se rechaza con 400 validation indicando el campo.
| Campo | Descripción |
|---|---|
items[].id | id del trabajo |
items[].tool | ruta de la herramienta |
items[].status, items[].title, items[].language | estado, título, idioma |
items[].city, items[].country | dirección del inmueble, si la hay |
items[].street, items[].streetNumber | calle y número, si los hay |
items[].previewUrl, items[].link | imagen de vista previa y el PDF terminado, si los hay (descarga con GET /artifacts/{path}); la vista previa de un flyer es la propia imagen (data:image/...) |
items[].object | el inmueble para el que se hizo el resultado: id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | cuántas veces se regeneró; un texto genérico si el trabajo falló |
items[].createdAt | fecha de creación |
nextCursor | para la página siguiente; null, no hay más páginas |