Dokumentacja API

Publiczne API CrystalCut do programatycznego usuwania tła i optymalizacji zdjęć produktowych.

Autoryzacja

Wszystkie requesty wymagają nagłówka:

Authorization: Bearer cbg_live_xxxxxxxxxxxxxxxx

Klucz API tworzysz w Dashboard → API Keys.

Endpoint

POST https://twoja-domena.pl/api/v1/remove-bg

Request Body

{
  "image_url": "https://example.com/product.jpg",  // preferowane
  "image_b64": "...",                              // opcjonalnie
  "fill_ratio": 0.88,                              // domyślnie 0.88
  "canvas_size": 1024                              // domyślnie 1024
}

Przykład (curl)

curl -X POST https://twoja-domena.pl/api/v1/remove-bg \
  -H "Authorization: Bearer cbg_live_TWOJ_KLUCZ" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/czajnik.jpg",
    "fill_ratio": 0.88,
    "canvas_size": 1024
  }'

Sukces (200)

{
  "status": "success",
  "id": "clx...",
  "image_url": "https://cdn.twoja-domena.pl/thumbnails/processed_....jpg",
  "fill_ratio": 0.88,
  "canvas_size": 1024,
  "credits_remaining": 42
}

Kody błędów

StatusKodOpis
400INVALID_REQUESTNieprawidłowe body
401UNAUTHORIZEDBrak lub zły API key
402INSUFFICIENT_CREDITSBrak kredytów
429RATE_LIMIT_EXCEEDEDZa dużo requestów
500PROCESSING_FAILEDBłąd przetwarzania (kredyt nie jest pobierany)

Ważne uwagi

  • 1 udane przetworzenie = 1 kredyt
  • Przy błędzie AI / RunPod kredyt nie jest pobierany
  • Preferuj image_url zamiast base64 (szybsze i tańsze)
  • Maksymalny rozmiar canvas: 2048 px
  • Przetworzone obrazy są automatycznie usuwane po 30 dniach zgodnie z polityką retencji danych (GDPR).