142 lines
3.0 KiB
Markdown
142 lines
3.0 KiB
Markdown
---
|
|
summary: "Use PixelML multi-model API in Clawdbot"
|
|
read_when:
|
|
- You want to use PixelML models in Clawdbot
|
|
- You need PixelML setup guidance
|
|
---
|
|
# PixelML
|
|
|
|
PixelML provides a unified OpenAI-compatible API for accessing multiple AI models including GPT-4o, Claude, and more.
|
|
|
|
## Features
|
|
|
|
- **Multi-model access**: Use GPT, Claude, and other models through a single API
|
|
- **OpenAI-compatible**: Standard `/v1` endpoints for easy integration
|
|
- **Streaming**: Supported on all models
|
|
- **Vision**: Supported on models with vision capability
|
|
|
|
## Setup
|
|
|
|
### 1. Get API Key
|
|
|
|
1. Sign up at [platform.pixelml.com](https://platform.pixelml.com)
|
|
2. Go to your account settings and create an API key
|
|
3. Copy your API key
|
|
|
|
### 2. Configure Clawdbot
|
|
|
|
**Option A: Environment Variable**
|
|
|
|
```bash
|
|
export PIXELML_API_KEY="your-api-key"
|
|
```
|
|
|
|
**Option B: Interactive Setup (Recommended)**
|
|
|
|
```bash
|
|
clawdbot onboard --auth-choice pixelml-api-key
|
|
```
|
|
|
|
This will:
|
|
1. Prompt for your API key (or use existing `PIXELML_API_KEY`)
|
|
2. Configure the provider automatically
|
|
3. Set the default model
|
|
|
|
**Option C: Non-interactive**
|
|
|
|
```bash
|
|
clawdbot onboard --non-interactive \
|
|
--auth-choice pixelml-api-key \
|
|
--pixelml-api-key "your-api-key"
|
|
```
|
|
|
|
### 3. Verify Setup
|
|
|
|
```bash
|
|
clawdbot chat --model pixelml/gpt-4o-mini "Hello, are you working?"
|
|
```
|
|
|
|
## Available Models
|
|
|
|
| Model ID | Name | Context | Features |
|
|
|----------|------|---------|----------|
|
|
| `gpt-4o-mini` | GPT-4o Mini | 128k | Vision |
|
|
| `gpt-4o` | GPT-4o | 128k | Vision |
|
|
| `claude-4.5-haiku` | Claude 4.5 Haiku | 200k | Vision |
|
|
| `claude-4.5-sonnet` | Claude 4.5 Sonnet | 200k | Vision, Reasoning |
|
|
|
|
## Model Selection
|
|
|
|
Change your default model anytime:
|
|
|
|
```bash
|
|
clawdbot models set pixelml/gpt-4o-mini
|
|
clawdbot models set pixelml/claude-4.5-sonnet
|
|
```
|
|
|
|
List all available models:
|
|
|
|
```bash
|
|
clawdbot models list | grep pixelml
|
|
```
|
|
|
|
## Usage Examples
|
|
|
|
```bash
|
|
# Use GPT-4o Mini (default)
|
|
clawdbot chat --model pixelml/gpt-4o-mini "Hello"
|
|
|
|
# Use Claude via PixelML
|
|
clawdbot chat --model pixelml/claude-4.5-sonnet "Write a poem"
|
|
|
|
# Use GPT-4o for vision tasks
|
|
clawdbot chat --model pixelml/gpt-4o
|
|
```
|
|
|
|
## Config File Example
|
|
|
|
```json5
|
|
{
|
|
env: { PIXELML_API_KEY: "your-api-key" },
|
|
agents: { defaults: { model: { primary: "pixelml/gpt-4o-mini" } } },
|
|
models: {
|
|
mode: "merge",
|
|
providers: {
|
|
pixelml: {
|
|
baseUrl: "https://ishi.pixelml.com/v1",
|
|
apiKey: "${PIXELML_API_KEY}",
|
|
api: "openai-completions",
|
|
models: [
|
|
{
|
|
id: "gpt-4o-mini",
|
|
name: "GPT-4o Mini",
|
|
reasoning: false,
|
|
input: ["text", "image"],
|
|
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
contextWindow: 128000,
|
|
maxTokens: 16384
|
|
}
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### API key not recognized
|
|
|
|
```bash
|
|
echo $PIXELML_API_KEY
|
|
clawdbot models list | grep pixelml
|
|
```
|
|
|
|
### Connection issues
|
|
|
|
PixelML API is at `https://ishi.pixelml.com/v1`. Ensure your network allows HTTPS connections.
|
|
|
|
## Links
|
|
|
|
- [PixelML](https://platform.pixelml.com)
|