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-bgRequest 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
| Status | Kod | Opis |
|---|---|---|
| 400 | INVALID_REQUEST | Nieprawidłowe body |
| 401 | UNAUTHORIZED | Brak lub zły API key |
| 402 | INSUFFICIENT_CREDITS | Brak kredytów |
| 429 | RATE_LIMIT_EXCEEDED | Za dużo requestów |
| 500 | PROCESSING_FAILED | Błą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_urlzamiast base64 (szybsze i tańsze) - Maksymalny rozmiar canvas: 2048 px
- Przetworzone obrazy są automatycznie usuwane po 30 dniach zgodnie z polityką retencji danych (GDPR).