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.