Контент і відео

Усі чотири інструменти працюють завданням: відповідь 202, результат - опитуванням або вебхуком (Завдання і результати). Голос, музику, фінальну фразу і аватар обирають з довідників (Довідкові дані).

Пакет контенту

POST /content/generate - область tools:contentgen. З фактів об'єкта і фото GREM робить описи, пости для соцмереж, озвучене відео, сайт і PDF - одним завданням. Під пакет створюється чернетка об'єкта.

Потрібно щонайменше 4 фото - публічними адресами в form.media.photos. Свої файли спершу завантажте через POST /uploads і передайте отримані url (Файли).

Поле user не потрібне: пакет створюється від імені акаунта ключа.

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"] }
    }
  }'

Відповідь 202: jobId (id завдання) і propertyId (чернетка об'єкта). Готове завдання (GET /content/generate/jobs/{id}) містить:

Файл: GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. Події - content.completed, content.partial (частина файлів не вийшла), content.failed. Менше 4 фото - 400.

Тексти оголошення

POST /text/generate - область tools:text. Опис, презентація і пост для соцмереж. Потрібен або objectId, або хоча б одне з: description, city, totalArea - інакше 422 з 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 з jobId. Тексти - у файлах завдання, як у пакета контенту; завдання також містить progress, masterProfile і error. Події - text.completed / text.failed.

Відео з фото

POST /video/create - область tools:video. Коротке озвучене відео з ваших фото або з фото об'єкта.

Тіло - multipart/form-data, кожен параметр окремим полем форми (не JSON у полі 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=Sunny 2-room flat in Berlin Mitte, quiet courtyard" \
  -F "length=short" -F "aspect=9:16" -F "language=en"

Відповідь 202 з jobId; відео - у файлах завдання. Завдання також містить progress, masterProfile і error, як у пакета контенту. Ціна залежить від length. Події - video.completed / video.failed.

Відео з аватаром

POST /avatar/video - область tools:avatar. Ведучий розповідає про ваш об'єкт.

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 з jobId. Відео: GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download, artifactId — з artifacts готового завдання. Події - avatar.completed / avatar.failed. Без avatarId, objectId або з коротким текстом - 400 з полями в errors.

Пов'язані статті

• Довідкові дані - голоси, аватари, музика, фінальні фрази.
• Завдання і результати - стани і файли.
• Файли - завантаження фото.