İki araç da dosyayı multipart/form-data olarak alır.
Fotoğraf iyileştirme
POST /photo/enhance: tools:photo kapsamı, iş. İstek başına bir fotoğraf.
Form parçaları:
| Parça | Açıklama |
|---|---|
image | fotoğraf: zorunlu; en fazla 25 MB JPEG, PNG veya WebP |
mask | yalnızca cleanup: PNG maske, beyaz değiştirilecek alanı işaretler |
data | tek bir JSON dizesi olarak seçenekler: zorunlu |
data içindeki seçenekler:
| Alan | Açıklama |
|---|---|
mode | enhance: ışık, renk, netlik; cleanup: nesneleri kaldırma; staging: boş bir odayı döşeme. Varsayılan cleanup |
prompt | cleanup ve staging için zorunlu (3 ile 500 karakter): neyin kaldırılacağı veya nasıl döşeneceği; enhance için isteğe bağlı |
intensity | light, medium (varsayılan), strong |
roomType | living, bedroom, kitchen, bathroom, dining, office, outdoor |
furnitureStyle | staging için: modern, scandinavian, industrial, luxury, minimalist, coastal |
autoMask | kendi maskesi olmayan cleanup: alanı otomatik bulma |
seed | tekrarlanabilir sonuç için bir sayı |
negativePrompt | kaçınılacak şey, 300 karaktere kadar |
objectId, objectType | fotoğrafın ait olduğu ilanınız (property veya complex) |
curl -X POST https://developers.grem.capital/api/v1/photo/enhance \
-H "Authorization: Bearer gsk_live_xxx" \
-F 'data={"mode":"cleanup","prompt":"sandalyeyi ve kutuları kaldır"}' \
-F "[email protected]"
enhance veya staging ile gönderilen maske reddedilir: orada etkisi yoktur ve ücret alınmaz. Fiyat moda bağlıdır. Retler: cleanup dışında maske: code: MASK_NOT_SUPPORTED ile 422; başka dosya türü veya 25 MB üstü dosya: code: JOB_CREATE_FAILED ile 422; data içinde bilinmeyen anahtar: 400. Başlatma yanıtı sku ve priceMinor taşır: çağrının ücreti (plan kotası karşılıyorsa yoktur).
jobId ile 202. Biten iş (GET /photo/enhance/jobs/{id}):
| Alan | Açıklama |
|---|---|
results | sonuç varyantları |
results[].variant | varyant numarası |
results[].url | görsel adresi |
results[].width, results[].height | boyut |
metadata.error | başarısız bir işte: neden, genel bir metin olarak |
Bir varyantın dosyası: GET /artifacts/v1/ai/photo-enhancement/jobs/{jobId}/download/{variant}. Olaylar: photo.completed / photo.failed.
Kat planı temizleme
POST /floorplan/create: tools:floorplan kapsamı. Bir kat planının fotoğrafı veya taraması, oda adları ve alanları olan temiz bir plana dönüşür. Hemen işlenir: 202 zaten sonucu içerir.
| Parça | Açıklama |
|---|---|
file | plan görseli (JPEG, PNG, WebP, HEIC; 20 MB'a kadar): zorunlu; image adı da kabul edilir |
objectId | sonucu ilanınıza ekleme |
objectType | property, rental veya complex |
curl -X POST https://developers.grem.capital/api/v1/floorplan/create \
-H "Authorization: Bearer gsk_live_xxx" \
-F "[email protected]"
Yanıt:
| Alan | Açıklama |
|---|---|
jobId | iş kimliği |
status | done: adlar otomatik kabul edildi; review: sonuç hazır, adların kontrol edilmesi önerilir; rejected: görsel bir plan değil; failed: hata |
state | done ve review için completed, rejected ve failed için failed |
rooms | odalar: label, area (yazılıysa m²), stable (etiket her geçişte aynı okundu), placement (etiketin temizlenmiş plandaki yeri) |
totalArea | planda alanlar yazılıysa toplam alan, m² |
cleanedFileId | temizlenmiş plan görseli |
sourceFileId | yüklediğiniz plan |
Rapor: GET /artifacts/v1/ai/floor-plan/jobs/{id}/report.pdf. Sonucu yeniden almak için: GET /floorplan/create/jobs/{id}. Olaylar: floorplan.completed / floorplan.failed. Görsel bir plan değilse ücret alınmaz.