Kontent və video

Dörd alətin hamısı tapşırıq kimi işləyir: 202 cavabı, nəticə isə status sorğulaması və ya vebhuk ilə (Tapşırıqlar və nəticələr). Səs, musiqi, yekun ifadə və avatar arayış siyahılarından seçilir (Arayış məlumatları).

Kontent paketi

POST /content/generate - tools:contentgen icazəsi. Obyekt haqqında faktlardan və fotolardan GREM bir tapşırıqda təsvirlər, sosial şəbəkə postları, səsləndirilmiş video, lendinq səhifəsi və PDF hazırlayır. Paket üçün obyekt qaralaması yaradılır.

Ən azı 4 foto tələb olunur - form.media.photos sahəsində açıq ünvanlar kimi. Öz fayllarınızı əvvəlcə POST /uploads ilə yükləyin və qaytarılan url-ləri ötürün (Fayllar).

user sahəsi lazım deyil: paket açarın hesabı adından yaradılır.

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 cavabı: jobId (tapşırığın identifikatoru) və propertyId (obyekt qaralaması). Tamamlanmış tapşırıqda (GET /content/generate/jobs/{id}) bunlar olur:

Fayl: GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. Hadisələr - content.completed, content.partial (bəzi fayllar alınmayıb), content.failed. 4-dən az foto - 400.

Obyekt mətnləri

POST /text/generate - tools:text icazəsi. Təsvir, təqdimat və sosial şəbəkə postu. Ya objectId, ya da description, city, totalArea sahələrindən ən azı biri lazımdır - əks halda code: not_enough_input ilə 422.

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

jobId ilə 202. Mətnlər kontent paketində olduğu kimi tapşırığın fayllarındadır; tapşırıqda həmçinin progress, masterProfile və error olur. Hadisələr - text.completed / text.failed.

Fotolardan video

POST /video/create - tools:video icazəsi. Fotolarınızdan və ya obyektin fotolarından səsləndirilmiş qısa video.

Gövdə - multipart/form-data, hər parametr ayrıca forma sahəsi kimi (data sahəsində JSON kimi deyil):

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"

jobId ilə 202; video tapşırığın fayllarındadır. Kontent paketində olduğu kimi, tapşırıqda həmçinin progress, masterProfile və error olur. Qiymət length dəyərindən asılıdır. Hadisələr - video.completed / video.failed.

Avatarlı video

POST /avatar/video - tools:avatar icazəsi. Aparıcı obyektiniz haqqında danışır.

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":"..."}'

jobId ilə 202. Video: GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download, artifactId tamamlanmış tapşırığın artifacts sahəsindən götürülür. Hadisələr - avatar.completed / avatar.failed. avatarId, objectId olmadıqda və ya mətn qısa olduqda - errors sahəsində sahələrin siyahısı ilə 400.

Əlaqəli

• Arayış məlumatları - səslər, avatarlar, musiqi, yekun ifadələr.
• Tapşırıqlar və nəticələr - vəziyyətlər və fayllar.
• Fayllar - fotoların yüklənməsi.