Contenido y vídeo

Las cuatro herramientas funcionan como trabajos: respuesta 202, el resultado por consulta o webhook (Trabajos y resultados). La voz, la música, la frase final y el avatar se eligen de las listas de referencia (Datos de referencia).

Paquete de contenido

POST /content/generate: ámbito tools:contentgen. A partir de los datos del inmueble y de las fotos, GREM crea descripciones, publicaciones para redes, un vídeo con locución, una página de aterrizaje y un PDF, en un solo trabajo. Para el paquete se crea un borrador de inmueble.

Se necesitan al menos 4 fotos, como direcciones públicas en form.media.photos. Suba antes sus propios archivos con POST /uploads y pase las url devueltas (Archivos).

No hace falta el campo user: el paquete se crea en nombre de la cuenta de la clave.

curl -X POST https://developers.grem.capital/api/v1/content/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0c0e3a5b-7d1e-4b8a-9b2f-1e6d4c3a2b10" \
  -d '{
    "form": {
      "language": "spa",
      "propertyCategory": "apartment", "dealType": "sale",
      "title": "Piso luminoso de 2 habitaciones junto al parque",
      "totalArea": 64, "rooms": 2, "price": 320000, "priceCurrency": "EUR",
      "addressCountry": "Germany", "addressCity": "Berlin",
      "media": { "photos": ["https://example.com/1.jpg", "https://example.com/2.jpg",
                             "https://example.com/3.jpg", "https://example.com/4.jpg"] }
    }
  }'

Respuesta 202: jobId (id del trabajo) y propertyId (el borrador del inmueble). El trabajo terminado (GET /content/generate/jobs/{id}) contiene:

Archivo: GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. Eventos: content.completed, content.partial (algunos archivos fallaron), content.failed. Menos de 4 fotos, 400.

Textos del anuncio

POST /text/generate: ámbito tools:text. Una descripción, una presentación y una publicación para redes. Se necesita objectId o al menos uno de description, city, totalArea; si no, 422 con code: not_enough_input.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"city":"Berlin","totalArea":64,"rooms":2,"propertyCategory":"apartment","language":"es","description":"Reformado, patio tranquilo, a 5 minutos del metro."}'

202 con jobId. Los textos están en los archivos del trabajo, como en el paquete de contenido; el trabajo lleva además progress, masterProfile y error. Eventos: text.completed / text.failed.

Vídeo a partir de fotos

POST /video/create: ámbito tools:video. Un vídeo corto con locución a partir de sus fotos o de las fotos de un inmueble.

Cuerpo: multipart/form-data, cada opción como campo de formulario propio (no JSON en un campo data):

curl -X POST https://developers.grem.capital/api/v1/video/create \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" -F "[email protected]" -F "[email protected]" \
  -F "prompt=Piso soleado de 2 habitaciones en Berlin Mitte, patio tranquilo" \
  -F "length=short" -F "aspect=9:16" -F "language=es"

202 con jobId; el vídeo está en los archivos del trabajo. El trabajo lleva además progress, masterProfile y error, como el paquete de contenido. El precio depende de length. Eventos: video.completed / video.failed.

Vídeo con avatar

POST /avatar/video: ámbito tools:avatar. Un presentador habla de su inmueble.

curl -X POST https://developers.grem.capital/api/v1/avatar/video \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"avatarId":"AVATAR_ID","objectId":"OBJECT_ID","voiceId":"VOICE_ID","scriptText":"..."}'

202 con jobId. Vídeo: GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download, con el artifactId de artifacts del trabajo terminado. Eventos: avatar.completed / avatar.failed. Si faltan avatarId u objectId o el texto es corto, 400 con los campos en errors.

Artículos relacionados

• Datos de referencia: voces, avatares, música, frases finales.
• Trabajos y resultados: estados y archivos.
• Archivos: subir fotos.