docs: document video generation + Grok Imagine image models in README

Author: 1bcMax

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to ClawRouter.
 
 ---
 
+## v0.12.155 — Apr 18, 2026
+
+- **Docs: video generation endpoint** — README now documents `POST /v1/videos/generations` with `xai/grok-imagine-video` ($0.05/sec, 8s default). The proxy handler, cost estimator (`estimateVideoCost`), and local-file download path were already in place in `proxy.ts`; only the README was missing.
+- **Docs: Grok Imagine image models** — README image table now includes `xai/grok-imagine-image` ($0.02) and `xai/grok-imagine-image-pro` ($0.07), already wired into the image pricing map.
+
+---
+
 ## v0.12.153 — Apr 16, 2026
 
 - **Claude Opus 4.7 flagship** — BlockRun API has promoted `anthropic/claude-opus-4.7` to flagship (1M context, 128K output, adaptive thinking; $5/$25 per 1M tokens). Added to `BLOCKRUN_MODELS`, now the primary for the `COMPLEX` routing tier across default/premium profiles and the new cost-savings `BASELINE_MODEL_ID`. Aliases: `opus`, `opus-4`, `anthropic/opus`, `anthropic/claude-opus-4`, and `anthropic/claude-opus-4.5` now resolve to 4.7. Explicit 4.6 pins (`opus-4.6`, `anthropic/claude-opus-4-6`) still route to 4.6, which the server keeps available. Opus 4.7 is also added to the curated `TOP_MODELS` picker list and `doctor` command. Opus 4.6 ClawRouter metadata updated to match server specs (1M/128K, was stale at 200K/32K).

README.md

@@ -18,8 +18,8 @@ Agents can only sign transactions.<br><br>
 
 [![npm version](https://img.shields.io/npm/v/@blockrun/clawrouter.svg?style=flat-square&color=cb3837)](https://npmjs.com/package/@blockrun/clawrouter)
 [![npm downloads](https://img.shields.io/npm/dm/@blockrun/clawrouter.svg?style=flat-square&color=blue)](https://npmjs.com/package/@blockrun/clawrouter)
-[![GitHub stars](https://img.shields.io/github/stars/BlockRunAI/ClawRouter?style=flat-square)](https://github.com/BlockRunAI/ClawRouter)
-[![CI](https://img.shields.io/github/actions/workflow/status/BlockRunAI/ClawRouter/ci.yml?style=flat-square&label=CI)](https://github.com/BlockRunAI/ClawRouter/actions)
+[![GitLab](https://img.shields.io/gitlab/stars/blockrunai/clawrouter?style=flat-square&gitlab_url=https%3A%2F%2Fgitlab.com&label=GitLab%20stars)](https://gitlab.com/blockrunai/clawrouter)
+[![pipeline status](https://img.shields.io/gitlab/pipeline-status/blockrunai%2Fclawrouter?branch=main&style=flat-square&label=CI)](https://gitlab.com/blockrunai/clawrouter/-/pipelines)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://typescriptlang.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
 
@@ -87,7 +87,7 @@ Done. Smart routing (`blockrun/auto`) is now your default model.
 
 ### Option B — Standalone (continue.dev, Cursor, VS Code, any OpenAI-compatible client)
 
-> **Using Claude Code?** Check out [BRCC](https://github.com/BlockRunAI/brcc) — it's purpose-built for Claude Code with the same smart routing and x402 payments.
+> **Using Claude Code?** Check out [BRCC](https://blockrun.ai/brcc.md) — it's purpose-built for Claude Code with the same smart routing and x402 payments.
 
 No OpenClaw required. ClawRouter runs as a local proxy on port 8402.
 
@@ -207,13 +207,32 @@ Generate images directly from chat with `/imagegen`:
 /imagegen --model banana-pro --size 2048x2048 mountain landscape
 ```
 
-| Model         | Provider              | Price       | Max Size  |
-| ------------- | --------------------- | ----------- | --------- |
-| `nano-banana` | Google Gemini Flash   | $0.05/image | 1024x1024 |
-| `banana-pro`  | Google Gemini Pro     | $0.10/image | 4096x4096 |
-| `dall-e-3`    | OpenAI DALL-E 3       | $0.04/image | 1792x1024 |
-| `gpt-image`   | OpenAI GPT Image 1    | $0.02/image | 1536x1024 |
-| `flux`        | Black Forest Flux 1.1 | $0.04/image | 1024x1024 |
+| Model                       | Provider              | Price       | Max Size  |
+| --------------------------- | --------------------- | ----------- | --------- |
+| `nano-banana`               | Google Gemini Flash   | $0.05/image | 1024x1024 |
+| `banana-pro`                | Google Gemini Pro     | $0.10/image | 4096x4096 |
+| `dall-e-3`                  | OpenAI DALL-E 3       | $0.04/image | 1792x1024 |
+| `gpt-image`                 | OpenAI GPT Image 1    | $0.02/image | 1536x1024 |
+| `flux`                      | Black Forest Flux 1.1 | $0.04/image | 1024x1024 |
+| `xai/grok-imagine-image`    | xAI Grok Imagine      | $0.02/image | 1024x1024 |
+| `xai/grok-imagine-image-pro`| xAI Grok Imagine Pro  | $0.07/image | 1024x1024 |
+| `zai/cogview-4`             | Zhipu CogView-4       | $0.015/image| 1440x1440 |
+
+## Video Generation
+
+Generate short AI videos via `POST http://localhost:8402/v1/videos/generations`. ClawRouter proxies the BlockRun gateway, handles x402 payment, and downloads the returned MP4 to local disk — the response `url` points to `http://localhost:8402/videos/<file>.mp4` so the asset survives past xAI's temporary bucket.
+
+```bash
+curl -X POST http://localhost:8402/v1/videos/generations \
+  -H "Content-Type: application/json" \
+  -d '{"model":"xai/grok-imagine-video","prompt":"a red apple slowly spinning"}'
+```
+
+| Model                    | Provider         | Price      | Duration  |
+| ------------------------ | ---------------- | ---------- | --------- |
+| `xai/grok-imagine-video` | xAI Grok Imagine | $0.05/sec  | 8s default |
+
+Calls block for 30–120s while xAI polls the job. Text-to-video and image-to-video (`image_url` parameter) are both supported.
 
 ## Image Editing (img2img)
 
@@ -449,8 +468,8 @@ npx @blockrun/clawrouter doctor opus "深度分析我的配置"
 ## Development
 
 ```bash
-git clone https://github.com/BlockRunAI/ClawRouter.git
-cd ClawRouter
+git clone https://gitlab.com/blockrunai/clawrouter.git
+cd clawrouter
 npm install
 npm run build
 npm test
@@ -487,16 +506,14 @@ You're here. 55+ models, local smart routing, x402 USDC payments — the only st
 </td>
 <td width="50%">
 
-### 🤖 [BRCC](https://github.com/BlockRunAI/brcc)
+### 🤖 [BRCC](https://blockrun.ai/brcc.md)
 
 **BlockRun for Claude Code**
 
 Run Claude Code with 50+ models, no rate limits, no Anthropic account, no phone verification. Pay per request with USDC — your wallet is your identity.
 
 `curl -fsSL https://blockrun.ai/brcc-install | bash`
 
-[![GitHub](https://img.shields.io/github/stars/BlockRunAI/brcc?style=flat-square)](https://github.com/BlockRunAI/brcc)
-
 </td>
 </tr>
 </table>