Kabinde kullandığınız araçların aynıları programlı olarak da kullanılabilir. Her çağrı, arayüzdeki çalışmayla tıpatıp aynı biçimde cüzdanınızdan karşılanır: önce abonelik, sonra paket, sonra kullandıkça öde. Okumalar (GET) hiçbir zaman ücretlendirilmez.
Temel adres: https://developers.grem.capital/api/v1.
Araçlar
| Çağrı | Gereken kapsam | Nasıl çalışır |
|---|---|---|
POST /valuation/express | herhangi bir anahtar | eşzamanlı |
POST /valuation/report | tools:valuation | ertelenmiş |
POST /valuation/rent | tools:rent | eşzamanlı |
POST /valuation/review | tools:review | ertelenmiş, dosyalı |
POST /content/generate | tools:contentgen | ertelenmiş |
POST /text/generate | tools:text | ertelenmiş |
POST /avatar/video | tools:avatar | ertelenmiş |
POST /video/create | tools:video | ertelenmiş, dosyalı |
POST /photo/enhance | tools:photo | ertelenmiş, dosyalı |
POST /floorplan/create | tools:floorplan | ertelenmiş, dosyalı |
POST /draft/extract | tools:draft | eşzamanlı, dosyalı |
POST /site/create | tools:sitegen | eşzamanlı, ilan ister |
POST /pdf/create | tools:pdf | ertelenmiş, ilan ister |
Anahtarda kapsam yoksa çağrı 403 döndürür. Kapsamlar, anahtarı kabinde oluştururken verilir: Yapay zekâ araçları → API → Anahtarlar. Bkz. Kimlik doğrulama.
Eşzamanlı çağrılar
Eşzamanlı bir araç, biten sonucu yanıt gövdesinde 200 ile döndürür:
curl -X POST https://developers.grem.capital/api/v1/valuation/rent \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"propertyCategory":"apartment","totalArea":50,"city":"Kyiv"}'
Ertelenmiş çağrılar
Uzun süren araçlar (değerleme raporu, metinler, fotoğraf, video, avatar, kat planı, PDF) 202 ve görev için bir tutamaç döndürür:
{ "jobId": "…", "status": "pending", "requestId": "req_…" }
Durumu GET /<aracın yolu>/jobs/{jobId} adresinden yoklayın:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/content/generate/jobs/JOB_ID
Yanıt bir status alanı taşır. Son durumlar completed (ya da done, success) ve failed'dir. Görev sürerken isteği birkaç saniyede bir yineleyin.
Yoklama ücretsizdir: GET API çağrısı sayılmaz ve ücretlendirilmez. Yine de sık yoklamak yerine olaya abone olmak daha iyidir - bkz. Webhook'lar.
Her görev, onu oluşturan anahtara aittir. Başkasının jobId değeri, öyle bir görev var olsa bile her zaman 404 döndürür.
Dosya alan araçlar
«Dosyalı» işaretli çağrılar multipart/form-data bekler: seçenekler data adlı bir metin alanına JSON olarak, dosya ise ayrı bir parça olarak gönderilir.
curl -X POST https://developers.grem.capital/api/v1/photo/enhance \
-H "Authorization: Bearer gsk_live_xxx" \
-F 'data={"mode":"enhance"}' \
-F "image=@room.jpg"
Bunlardan birine düz JSON göndermek, multipart/form-data beklendiği notuyla 400 döndürür.
İlan gerektiren araçlar
Site üreteci ile PDF üreteci sunumu var olan bir ilandan kurar; bu yüzden istek gövdesi bir objectId (ya da seçki için bir collectionId) taşımalıdır. İlan sizin olmalıdır - başkasının kimliği erişim hatası döndürür.
curl -X POST https://developers.grem.capital/api/v1/pdf/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"objectId":"64f…","language":"en"}'
Biten dosyalar
Sonuçlar (PDF, video, görsel, sayfa) GREM alan adındaki bağlantılar olarak döner. Onları aynı anahtarla GET /artifacts/… üzerinden indirin - bkz. Dosyalar ve sonuçlar.
Çift işlem olmadan yineleme
Görev oluşturmayı güvenle yineleyebilirsiniz: Idempotency-Key başlığını gönderin; aynı anahtarla yapılan yineleme, iki kez ücret almak yerine özgün sonucu döndürür. Ayrıntılar: Idempotence.
Hatalar ne anlama gelir
402- cüzdanda para yetmiyor ya da tarife kotası bitmiş.403- anahtarın bu araç için kapsamı yok.429- hız sınırına ulaşıldı;Retry-Afterbaşlığındaki bekleme süresinden sonra yeniden deneyin.
Tam liste Hatalar yazısındadır.
İlgili yazılar
- Hızlı başlangıç - beş dakikada ilk çağrınız.
- Webhook'lar - yoklamak yerine biten sonucu almak.
- Dosyalar ve sonuçlar - görsel yükleme ve yapıt indirme.