AugeLabKaynak Kontrol

API belgesi

Bir görüntü gönder, kararı ve ölçüleri JSON olarak al.

Kimlik doğrulama

Her istekte anahtarını Authorization başlığında gönder. Anahtarlar agl_weld_ ile başlar.

Authorization: Bearer agl_weld_xxxxxxxxxx_...

Görüntü kontrolü

POST https://weld.augelab.com/api/v1/inspect

Görüntüyü multipart/form-data içinde image alanıyla ya da doğrudan istek gövdesi olarak (Content-Type: image/jpeg veya image/png) gönder.

curl -X POST "https://weld.augelab.com/api/v1/inspect" \
  -H "Authorization: Bearer $AUGELAB_WELD_KEY" \
  -F "image=@weld.jpg" \
  -F "mm_per_pixel=0.12" \
  -F "reference=P-1042"
import os, requests

with open("weld.jpg", "rb") as f:
    r = requests.post(
        "https://weld.augelab.com/api/v1/inspect",
        headers={"Authorization": "Bearer " + os.environ["AUGELAB_WELD_KEY"]},
        files={"image": f},
        data={"mm_per_pixel": "0.12"},
        timeout=60,
    )
r.raise_for_status()
print(r.json()["verdict"])

Parametreler

image
JPEG veya PNG, en fazla 8 MB.
mm_per_pixel
İsteğe bağlı. Yüklediğin görüntünün bir pikselinin kaç milimetre olduğu. Verilirse yanıtta mm alanları da bulunur.
reference
İsteğe bağlı. Parça numarası gibi kısa bir not; rapora yazılır.
allow_training
İsteğe bağlı, varsayılan false. true gönderirsen görüntü model geliştirme için saklanabilir.

Yanıt

verdict alanı OK, NOK ya da UNCERTAIN (belirsiz) olur. Güven düşükse, görüntü bulanık ya da karanlıksa veya dikiş bulunamazsa UNCERTAIN döner.

Koordinatlar işlenen görüntünün pikselleridir (image.width, image.height). Büyük görüntüler küçültülerek işlenir; image.scale_factor oranı verir. Bağlantılar 24 saat sonra geçersiz olur.

{
  "verdict": "NOK",
  "verdict_reasons": ["porosity_detected"],
  "image": {"width": 1600, "height": 1200, "original_width": 4000, "original_height": 3000,
            "scale_factor": 0.4, "mm_per_pixel": 0.3},
  "defect_counts": {"crack": 0, "porosity": 1, "spatter": 0},
  "defects": [
    {"id": 1, "class_id": 2, "class": "porosity", "confidence": 0.87,
     "box": {"x": 812, "y": 590, "width": 14, "height": 13},
     "polygon": [[812, 596], [818, 590], [825, 596], [819, 602]],
     "length_px": 14.2, "width_px": 13.1, "area_px": 141,
     "length_mm": 4.26, "width_mm": 3.93, "area_mm2": 12.69}
  ],
  "defects_truncated": false,
  "bead": {"found": true, "segments": 1, "polygon": [[96, 560], [1504, 548], [1504, 642], [96, 655]],
           "area_px": 131000, "length_px": 1408.0, "mean_width_px": 93.0, "confidence": 0.93,
           "length_mm": 422.4, "mean_width_mm": 27.9, "area_mm2": 11790.0},
  "warnings": [],
  "model": {"name": "...", "version": "...", "is_mock": false, "experimental": false},
  "request_id": "9f2c1a7d3b5e8a10",
  "created": "2026-11-17T12:00:00Z",
  "reference": "P-1042",
  "processing_ms": 412,
  "annotated_image": {"url": "https://.../f/<token>/annotated.jpg", "expires_at": "2026-11-18T12:00:00Z"},
  "reports": {"pdf_url": "...", "xlsx_url": "...", "json_url": "...", "expires_at": "2026-11-18T12:00:00Z"},
  "quota": {"remaining": {"per_minute": 4, "per_day": 299, "per_month": 2999}}
}

Sınırlar

Anahtar başına dakikada 5, günde 300, ayda 3000 görüntü. Ücretsiz anahtarların tümü için ortak bir tavan da vardır. Sınır aşılınca 429 yanıtı ve Retry-After başlığı döner.

Hatalar

Hata yanıtları error.code, error.message ve error.request_id alanlarını içerir.

401
Anahtar yok, geçersiz ya da iptal edilmiş.
413
Dosya ya da görüntü boyutu sınırın üzerinde.
415
JPEG ya da PNG olmayan içerik.
429
Sınır aşıldı. Retry-After saniye sonra yeniden dene.
503
Sistem dolu ya da geçici olarak kapalı. Kısa süre sonra yeniden dene.

Diğer uçlar

GET /api/v1/me
Anahtarın sınırlarını ve kalan haklarını verir.
DELETE /api/v1/key
Anahtarı iptal eder.

Bu araç bir karar destek aracıdır; kaynak muayenesinin, tahribatsız muayenenin veya yetkili personel kararının yerini tutmaz. Sonuçlar yalnız fotoğrafta görünen yüzeye dayanır ve hatalı olabilir.