Error Handling

KiteFishAIError
├── AuthenticationError   # 401 — invalid or missing API key
├── RateLimitError        # 429 — too many requests
├── NotFoundError         # 404 — model or resource not found
└── APIError              # any other non-2xx response

import kitefishai

client = kitefishai.Client(api_key="kf-...")

try:
    response = client.chat.complete(
        model="kf-reasoning-10b",
        messages=[{"role": "user", "content": "Hello"}],
    )
except kitefishai.AuthenticationError:
    print("Invalid API key — check KITEFISH_API_KEY")
except kitefishai.RateLimitError:
    print("Rate limit hit — back off and retry")
except kitefishai.NotFoundError as e:
    print(f"Model not found: {e}")
except kitefishai.APIError as e:
    print(f"API error {e.status_code}: {e.message}")
except kitefishai.KiteFishAIError as e:
    print(f"SDK error: {e}")

client = kitefishai.Client(
    api_key="kf-...",
    timeout=120.0,
)

client = kitefishai.Client(
    api_key="kf-...",
    max_retries=3,
)

client = kitefishai.Client(api_key="kf-...", max_retries=0)