Contenu et vidéo

Les quatre outils fonctionnent sous forme de tâches : une réponse 202, puis le résultat par interrogation ou par webhook (Tâches et résultats). La voix, la musique, la phrase de clôture et l'avatar se choisissent dans les listes de référence (Données de référence).

Pack de contenu

POST /content/generate - scope tools:contentgen. À partir des caractéristiques du bien et des photos, GREM produit des descriptions, des publications pour les réseaux sociaux, une vidéo commentée, une page de destination et un PDF - en une seule tâche. Un brouillon d'annonce est créé pour le pack.

Au moins 4 photos sont requises - sous forme d'adresses publiques dans form.media.photos. Envoyez d'abord vos propres fichiers avec POST /uploads et transmettez les url renvoyées (Fichiers).

Aucun champ user n'est nécessaire : le pack est créé au nom du compte de la clé.

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": "eng",
      "propertyCategory": "apartment", "dealType": "sale",
      "title": "Bright 2-room flat near the park",
      "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"] }
    }
  }'

Réponse 202 : jobId (identifiant de la tâche) et propertyId (le brouillon d'annonce). La tâche terminée (GET /content/generate/jobs/{id}) contient :

Fichier : GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. Événements - content.completed, content.partial (certains fichiers ont échoué), content.failed. Moins de 4 photos - 400.

Textes d'annonce

POST /text/generate - scope tools:text. Une description, une présentation et une publication pour les réseaux sociaux. Nécessite soit objectId, soit au moins l'un des champs description, city, totalArea - sinon 422 avec 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":"en","description":"Renovated, quiet courtyard, 5 min to U-Bahn."}'

202 avec jobId. Les textes se trouvent dans les fichiers de la tâche, comme pour le pack de contenu ; la tâche contient aussi progress, masterProfile et error. Événements - text.completed / text.failed.

Vidéo à partir de photos

POST /video/create - scope tools:video. Une courte vidéo commentée à partir de vos photos ou des photos d'une annonce.

Corps - multipart/form-data, chaque option dans son propre champ de formulaire (et non du JSON dans un champ data) :

curl -X POST https://developers.grem.capital/api/v1/video/create \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "photos=@living.jpg" -F "photos=@kitchen.jpg" -F "photos=@view.jpg" \
  -F "prompt=Sunny 2-room flat in Berlin Mitte, quiet courtyard" \
  -F "length=short" -F "aspect=9:16" -F "language=en"

202 avec jobId ; la vidéo se trouve dans les fichiers de la tâche. La tâche contient aussi progress, masterProfile et error, comme pour le pack de contenu. Le prix dépend de length. Événements - video.completed / video.failed.

Vidéo avec avatar

POST /avatar/video - scope tools:avatar. Un présentateur parle de votre annonce.

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 avec jobId. Vidéo : GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download, artifactId issu des artifacts de la tâche terminée. Événements - avatar.completed / avatar.failed. avatarId ou objectId manquant, ou texte trop court - 400 avec les champs dans errors.

Voir aussi

• Données de référence - voix, avatars, musique, phrases de clôture.
• Tâches et résultats - états et fichiers.
• Fichiers - envoi de photos.