---
title: Unsplashi pildid
description: Otsib ja laadib alla pilte Unsplashist, soovi korral koos tekstiga.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# Unsplashi pildiotsing ja allalaadimine

Otsi Unsplashist pilte, laadi need alla ja valikuliselt lisa tekstikiht.

## Tööriista asukoht

- Skript: `~/.agents/tools/unsplash-search.py`
- Env-fail: `~/.agents/tools/.env` (sisaldab `UNSPLASH_CLIENT_ID`)

## Kiirkasutus

### Otsi ja laadi alla juhuslik sobiv pilt

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "nature landscape" \
  --output ./image.jpg
```

### Orientatsioonifiltriga

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "coffee shop" \
  --orientation landscape \
  --output ./coffee.jpg
```

### Tekstikihiga (pealkiri ja alapealkiri)

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "technology abstract" \
  --output ./cover.png \
  --title "My Blog Post Title" \
  --subtitle "A short description"
```

### Loetle tulemused ilma allalaadimata

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "sunset" \
  --list
```

### Vali esimene tulemus juhusliku asemel

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "mountains" \
  --pick first \
  --output ./mountains.jpg
```

## CLI valikud

| Valik | Kirjeldus |
|--------|-------------|
| `--query, -q` | **(Kohustuslik)** Otsingupäringu string |
| `--output, -o` | **(Kohustuslik, kui pole --list)** Väljundfaili tee |
| `--orientation` | Filter: `landscape`, `portrait` või `squarish` |
| `--color` | Värvifilter (nt `blue`, `green`, `red`, `black_and_white`) |
| `--pick` | Kuidas tulemustest valida: `random` (vaikimisi) või `first` |
| `--title` | Pealkirjatekst pildile kihina |
| `--subtitle` | Alapealkirjatekst kihina (kasutatakse ainult koos --title’iga) |
| `--list` | Loetle otsingutulemused allalaadimise asemel |
| `--count` | Tulemuste arv, max 30 (vaikimisi: 30) |

## Tekstikiht

Kui `--title` on antud, lisab skript pildi alumisse ossa tekstikihi:
- Poolläbipaistev tume taust teksti taga
- Valge pealkirjatekst varjuga
- Hall alapealkirjatekst (kui antud)
- Automaatne reamurdmine ja fondisuurus

**Nõuab Pillow’t**: `pip install Pillow`

## Sõltuvused

- `requests` (API-kutsete ja pildi allalaadimise jaoks)
- `Pillow` (vajalik ainult tekstikihi jaoks koos `--title`iga)

Installi vajadusel:
```bash
pip install requests Pillow
```

## Väljund

Skript prindib:
- Allalaadimise URL-i
- Fotograafi atribuutsiooni (Unsplash nõuab)
- Salvestatud failitee
- Tekstikihi kinnituse, kui see rakendati

## Märkused

- Unsplashi API juhised nõuavad atribuutsiooni. Skript prindib fotograafi info.
- Skript käivitab Unsplashi allalaadimise jälgimise lõpp-punkti, nagu nende API tingimused nõuavad.
- Pildid laaditakse alla „regular“ kvaliteedis (1080px laius). Kõrgema resolutsiooni jaoks muuda skripti kasutama `urls.full` või `urls.raw`.