Las mismas herramientas que en el panel están disponibles de forma programática. Una herramienta cuesta lo mismo que en el panel, más una llamada a la API (Límites y cobro). Dirección base: https://developers.grem.capital/api/v1.
Lista
| Herramienta | Solicitud | Ámbito | Funcionamiento |
|---|---|---|---|
| Valoración exprés | POST /valuation/express | tools:valuation | al momento |
| Informe de valoración completo | POST /valuation/report | tools:valuation | trabajo |
| Estimación del alquiler | POST /valuation/rent | tools:rent | al momento |
| Revisión de informe | POST /valuation/review | tools:review | trabajo, con archivo, espera confirmación |
| Paquete de contenido | POST /content/generate | tools:contentgen | trabajo |
| Textos del anuncio | POST /text/generate | tools:text | trabajo |
| Vídeo a partir de fotos | POST /video/create | tools:video | trabajo, con archivos |
| Vídeo con avatar | POST /avatar/video | tools:avatar | trabajo |
| Mejora de fotos | POST /photo/enhance | tools:photo | trabajo, con archivo |
| Limpieza de planos | POST /floorplan/create | tools:floorplan | al momento (el 202 ya trae el resultado), con archivo |
| Página de aterrizaje del inmueble | POST /site/create | tools:sitegen | al momento |
| Presentación en PDF | POST /pdf/create | tools:pdf | trabajo |
| Folleto personal | POST /flyer/create | tools:flyer | al momento |
| Borrador a partir de documentos | POST /draft/extract | tools:draft | al momento, con archivos |
Campos, ejemplos y errores de cada herramienta:
- Valoración: exprés, informe completo, alquiler, revisión de informe.
- Contenido y vídeo: paquete de contenido, textos, vídeo, avatar.
- Fotos y planos: mejora de fotos, plano.
- Materiales del anuncio: página de aterrizaje, PDF, folleto, borrador.
Los ids que las herramientas toman como entrada (voz, avatar, música, frase final) y la disponibilidad actual: Datos de referencia.
Envío de datos
- JSON: la mayoría de herramientas,
Content-Type: application/json. - multipart/form-data: herramientas con archivos. La estructura de sus campos varía, y es importante:
- mejora de fotos y borrador: opciones como una cadena JSON en el campo
data, archivos como partes aparte; - vídeo: cada opción como campo de formulario propio (
prompt,length,musicTrackId...), fotos como partesphotos; - revisión de informe y plano: el archivo en la parte
file, las opciones como campos propios.
- mejora de fotos y borrador: opciones como una cadena JSON en el campo
Enviar JSON a una herramienta que espera un archivo da 400.
Respuestas
- Una herramienta síncrona responde
200con el resultado. - Una asíncrona responde
202con un trabajo; el resultado, por consulta o webhook (Trabajos y resultados). - Los archivos generados se descargan con
GET /artifacts/{path}.
Envíe cada solicitud que lance una herramienta con un Idempotency-Key (Idempotencia).
No disponible por API
El tour 3D y el informe de mercado de un barrio, por ahora, solo están disponibles en el panel.