# Images

> Skill `image` on Faro. 6 sub-skills.

Handles all image needs in one skill: generate brand-new images from text descriptions, find real stock photos matching a scene or subject, edit or restyle existing images with a natural-language instruction, upscale low-resolution images to sharp 2x or 4x, and remove backgrounds to a clean transparent cutout. The skill routes each request to the right approach automatically.

**Category:** Images  
**Tags:** image, generate, edit, resize, convert, transform, ai, 4k, upscale, background-removal, transparent  
**Use when:** You need an image, whether to generate one, find a real stock photo, or improve an existing image.  
**Not for:** Moderating images, reading text out of an image (OCR), making logos, or generating QR codes.  
**Returns:** file (image/png) — Returns a downloadable file, not base64. A stock-photo search may instead return candidate photos for the caller to choose from.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/image/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Get me a photo of the Rocky Mountains"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run image "Get me a photo of the Rocky Mountains"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Get me a photo of the Rocky Mountains
- Make me an image of a red fox in a snowy forest
- Resize this image to 800x600 and save it as WebP
- Upscale this image to 4x

## Sub-skills

### Find a stock photo

Finds a real photograph matching a description.

**Cost:** 0.1 credits / search

**Use when:** You want an authentic photo of a real, findable subject rather than a generated one.

**Details:** https://askfaro.com/llms/skills/image/find.md

---

### Generate

Creates a new image from a text description.

**Cost:** ~300 credits / image (up to 1500) — A standard image is the usual case; a 4K render costs more, up to ~6000 cr.

**Use when:** The subject does not exist yet and must be made (bespoke, branded, a specific scene).

**Details:** https://askfaro.com/llms/skills/image/generate.md

---

### Adjust

Resize, crop, convert, rotate, filter, or overlay a logo or text. No AI.

**Cost:** ~2 credits / megapixel (up to 6)

**Use when:** You want a mechanical change, including adding a logo or watermark.

**Details:** https://askfaro.com/llms/skills/image/adjust.md

---

### Upscale

Increases an image's resolution to 2x or 4x with added detail.

**Cost:** ~5 credits / image (up to 10)

**Use when:** You want an existing image larger or sharper, not regenerated.

**Details:** https://askfaro.com/llms/skills/image/upscale.md

---

### Remove background

Cuts the subject out to a transparent background.

**Cost:** ~150 credits / image (up to 800)

**Use when:** You want the subject isolated on transparency.

**Details:** https://askfaro.com/llms/skills/image/cutout.md

---

### Restyle or compose (AI)

AI edit, restyle, or compose an existing image from an instruction.

**Cost:** ~800 credits / image (up to 4000)

**Use when:** You want to change what the image looks like or combine images with AI.

**Details:** https://askfaro.com/llms/skills/image/restyle.md

---

---
On the web: https://askfaro.com/search/image