Контент и видео

Все четыре инструмента работают задачей: ответ 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.

Связанные статьи

• Справочные данные - голоса, аватары, музыка, финальные фразы.
• Задачи и результаты - состояния и файлы.
• Файлы - загрузка фото.