blueai-models

# BlueAI Models for OpenClaw ## Quick Start Add a model to OpenClaw: ```bash python3 scripts/add_model.py gemini-2.5-flash --alias flash python3 scripts/add_model.py claude-sonnet-4-6 --alias sonnet openclaw gateway restart ``` Test connectivity: ```bash python3 scripts/test_model.py gemini-2.5-flash python3 scripts/test_model.py --all-configured ``` List available models: ```bash python3 scripts/add_model.py --list ``` ## Image Generation Gemini image models generate images via **Chat Completions** (`/v1/chat/completions`), not the Images API. Send a prompt as a normal message; the model returns base64-encoded images in Markdown. ```bash # Add image models python3 scripts/add_model.py gemini-3.1-flash-image-preview python3 scripts/add_model.py gemini-3-pro-image-preview openclaw gateway restart # Test image generation python3 scripts/test_model.py gemini-3.1-flash-image-preview --image-gen python3 scripts/test_model.py gemini-3-pro-image-preview --image-gen --save ./test-output ``` | Model | Speed | Quality | Edit Support | Best For | |-------|-------|---------|-------------|----------| | `gemini-3.1-flash-image-preview` | ⚡ Fast | Good | ❌ | Quick prototypes, batch | | `gemini-3-pro-image-preview` | Medium | ⭐ Best | ✅ | High-quality creative | | `gemini-2.5-flash-image` | ⚡ Fast | Good | ✅ | Image editing | For detailed usage, prompt tips, Python examples, and edit workflows: read `references/image-generation.md`. ## Endpoints | Type | Base URL | Note | |------|----------|------| | Claude (Anthropic) | `https://bmc-llm-relay.bluemediagroup.cn` | **No /v1** | | Everything else (OpenAI) | `https://bmc-llm-relay.bluemediagroup.cn/v1` | **With /v1** | Same API key works for all models. ## Model Selection Quick Guide | Need | Model | Why | |------|-------|-----| | Cheapest + good | `gemini-2.5-flash` | $0.15/M in, 1M context | | Best Chinese | `DeepSeek-V3.2` | Top Chinese quality, cheap | | Vision + cheap | `gpt-4o-mini` or `gemini-2.5-flash` | Image input, low cost | | Strong reasoning | `o4-mini` or `DeepSeek-R1` | CoT reasoning | | Best overall | `claude-opus-4-6-v1` | 128K output, Agent coding | | Balanced | `claude-sonnet-4-6` | 1/5 Opus price, most tasks | | Code specialist | `gpt-5.2-codex` | 128K output, code focused | | Ultra-long context | `xai.grok-4-fast-non-reasoning` | 2M tokens | | **Image gen (fast)** | `gemini-3.1-flash-image-preview` | Chat-based, cheap | | **Image gen (quality)** | `gemini-3-pro-image-preview` | Best Gemini quality | | **Image edit** | `gemini-2.5-flash-image` | Send image + edit instruction | ## References - **Full model catalog**: Read `references/model-catalog.md` for all 100+ models with specs - **OpenClaw config guide**: Read `references/openclaw-config.md` for JSON structure and examples - **Model selection decision tree**: Read `references/model-selection.md` for task-based recommendations - **Image generation guide**: Read `references/image-generation.md` for Gemini image gen usage, prompts, and code examples ## Key Rules 1. Claude models use `api: "anthropic-messages"`, baseUrl without `/v1` 2. All other models use `api: "openai-completions"`, baseUrl with `/v1` 3. DeepSeek/Qwen text models: set `input: ["text"]` only (no image) 4. MiniMax: must use OpenAI endpoint, does not support Claude endpoint 5. `gemini-3-pro-preview` deprecated 2026-03-26 → use `gemini-3.1-pro-preview` 6. Gemini image models use chat completions, not images API — output is base64 in Markdown 7. After config changes: `openclaw gateway restart`