SurfSense/.serena/memories/trollllm-integration.md

# TrollLLM — Hướng dẫn tích hợp vào SurfSense

## Base URL
- OpenAI-compatible endpoint: `https://chat.trollllm.xyz/v1`
- Anthropic-compatible endpoint: `https://chat.trollllm.xyz` (không có /v1)

## Danh sách model chính xác (tên phải đúng 100%)
| Model ID | Provider | Ghi chú |
|---|---|---|
| `claude-haiku-4.5` | Anthropic | Speed |
| `claude-sonnet-4` | Anthropic | Balanced |
| `claude-sonnet-4.5` | Anthropic | Balanced |
| `claude-sonnet-4.6` | Anthropic | Balanced |
| `claude-opus-4.5` | Anthropic | Reasoning |
| `claude-opus-4.6` | Anthropic | Reasoning |
| `gemini-3-flash-preview` | Google | Speed (**KHÔNG phải** gemini-3-flash) |
| `gemini-3.1-pro-preview` | Google | Multimodal |
| `gpt-5.2` | OpenAI | Reasoning |
| `gpt-5.4` | OpenAI | Reasoning |
| `gpt-5.2-codex` | OpenAI | Code |
| `gpt-5.3-codex` | OpenAI | Code |

## Cách add model vào SurfSense (đúng cách)

### Cách 1 — Dùng Provider = OPENAI (khuyến nghị, dùng cho mọi model)
- **LLM Provider**: `OPENAI`
- **Model Name**: tên chính xác từ bảng trên (ví dụ `claude-sonnet-4.6`)
- **API Key**: TrollLLM API key
- **API Base URL**: `https://chat.trollllm.xyz/v1`

### Cách 2 — Dùng Custom Provider (LiteLLM format)
- **LLM Provider**: `Custom Provider`
- **Custom Provider Name**: tùy ý (ví dụ `trollllm`)
- **Model Name**: phải có prefix `openai/` → `openai/claude-sonnet-4.6`
- **API Key**: TrollLLM API key
- **API Base URL**: `https://chat.trollllm.xyz/v1`

## Lỗi phổ biến
1. **Tên model sai**: `gemini-3-flash` ❌ → phải là `gemini-3-flash-preview` ✅
2. **Custom Provider thiếu prefix**: `gemini-3-flash-preview` ❌ → `openai/gemini-3-flash-preview` ✅
3. **Base URL sai**: `https://trollllm.xyz/v1` ❌ → `https://chat.trollllm.xyz/v1` ✅

## Lưu ý đặc biệt
- TrollLLM yêu cầu `User-Agent` header để bypass Cloudflare, nhưng SurfSense/LiteLLM thường tự set header này.
- Nếu dùng Anthropic SDK format: dùng `x-api-key` header thay vì `Authorization: Bearer`.