Doubao AI Image Generator

---

# Doubao Image Generation Skill

Generate images using ByteDance's Doubao (豆包) AI image generation service via browser automation.

## Requirements

- OpenClaw browser (headless or profile) with access to `https://www.doubao.com`
- Doubao account must be logged in
- Workspace directory for temporary file storage

## Usage

### Basic Image Generation

1. Navigate to `https://www.doubao.com` and open the image generation mode
2. Enter the prompt and submit
3. Wait for generation to complete (typically 20-30 seconds)
4. Extract and download the generated images
5. Send images to the user

### Step-by-Step Process

#### 1. Open Doubao Image Generation

```
browser(action="open", url="https://www.doubao.com/chat/create-image", profile="openclaw")
```

Or navigate to existing chat with image gen history:

```
browser(action="snapshot", profile="openclaw")
```

#### 2. Enter Prompt

Find the text input and enter the image description:

```
browser(action="act", kind="fill", ref=<textbox-ref>, text="<prompt>", profile="openclaw")
browser(action="act", kind="press", key="Enter", profile="openclaw")
```

#### 3. Wait for Generation

Wait 10-20 seconds for the images to generate:

```
exec(command="sleep 15")
```

Then check if images are ready by taking a screenshot.

#### 4. Extract Image URLs

Use browser evaluate to extract image URLs from the page:

```javascript
// Find all generated images (image_generation URL pattern)
const imgs = document.querySelectorAll('img[src*="image_generation"]');
const urls = Array.from(imgs).map(img => ({
  src: img.src,
  w: img.naturalWidth,
  h: img.naturalHeight
}));
```

#### 5. Download Images

Use the `image_pre_watermark_1_5b` URL variant for highest quality (1773×2364):

```bash
curl -L -H "Referer: https://www.doubao.com/" \
  -H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)" \
  -o output.png "<url_with_image_pre_watermark>"
```

If the `image_pre_watermark` URL fails (signature mismatch), fall back to extracting via browser CDP WebSocket:

```javascript
// Connect to CDP and extract image via canvas
const dataUrl = await new Promise(resolve => {
  const canvas = document.createElement('canvas');
  canvas.width = img.naturalWidth;
  canvas.height = img.naturalHeight;
  const ctx = canvas.getContext('2d');
  ctx.drawImage(img, 0, 0);
  canvas.toBlob(blob => {
    const reader = new FileReader();
    reader.onload = () => resolve(reader.result);
    reader.readAsDataURL(blob);
  }, 'image/png');
});
```

#### 6. Send to User

Use `sendAttachment` for BlueBubbles/iMessage:

```
message(action="sendAttachment", channel="bluebubbles", filePath="<path>")
```

### Image URL Patterns

Doubao CDN serves multiple versions of generated images:

| URL Suffix | Resolution | Use Case |
|------------|------------|----------|
| `downsize_watermark_1_5_b.png` | ~288×384 | Thumbnail, watermarked |
| `image_pre_watermark_1_5b.png` | ~1773×2364 | High-res, no watermark |
| `image_dld_watermark_1_5b.png` | ~1773×2364 | Download version |
| `web-operation.webp` | ~435×580 | Web preview |

**Important**: Each URL requires a unique CDN signature (`x-signature`). You cannot simply swap URL suffixes — the signature must match the specific image and URL type.

### Prompts for Best Results

For high-quality image generation, include these keywords in prompts:
- Quality: "高精度", "高品质", "8K", "超高分辨率"
- Style: "专业摄影棚灯光", "工作室渲染", "景深效果"
- Details: "精美的细节", "精细纹理"

### Troubleshooting

1. **Page not loading**: Ensure browser has network access and Doubao is accessible
2. **Login required**: Check if Doubao session is still active via screenshot
3. **Images not generating**: Check for content policy blocks in the prompt
4. **Download fails**: Use browser CDP WebSocket extraction instead of direct download
5. **BlueBubbles media path blocked**: Use `sendAttachment` action instead of `send` with `filePath`

## Example Prompts

```
战斗暴龙兽3D手办，高精度模型，精美的细节，金属质感盔甲，蓝色闪耀的勇气之盾，动感战斗姿态，站在岩石底座上，专业摄影棚灯光，工作室渲染，高品质，8K
```

```
可爱柴犬头像，日式插画风格，柔和配色，圆润线条，温暖光影，专业插画师作品
```

```
赛博朋克城市夜景，霓虹灯，高楼大厦，雨天反射，电影级渲染，超高清细节
```

## Notes

- Doubao free tier has daily generation limits
- Generated images are stored in CDN with time-limited signatures
- Browser automation is required due to lack of public API
- Always use `sendAttachment` for BlueBubbles to avoid media path issues