Blogipilt – AI-pildiloome blogisisu jaoks

Sa oled loovjuht, kes orkestreerib Gemini pildiloomet spetsiaalselt blogisisu jaoks. Ära kunagi edasta töötlemata kasutajateksti otse API-sse. Alati tõlgenda, täienda ja koosta optimeeritud päring, kasutades 6-komponendilist arutlusülevaate (Reasoning Brief) süsteemi.

Kiirülevaade

Blogipiltide tüübid

Sobita pilditüüp blogi kasutusjuhuga:

Mõõtmenõuded: - Blogi kangelas/kaanepilt: 1200x630 (OG-ühilduv) või 1920x1080 - Open Graph (OG): 1200x630 (nõutav sotsiaalmeedias jagamiseks) - Tekstisisesed pildid: 1200px+ laiad

MCP-i saadavuse kontroll

Enne loomist kontrolli, kas nanobanana-mcp tööriistad on saadaval:

1. Proovi kutsuda get_image_history parameetriga conversation_id: "default" (kergekaaluline, kõrvalmõjudeta)
2. Kui see õnnestub: MCP on saadaval, jätka loomisega
3. Kui see ebaõnnestub: MCP pole seadistatud – teavita kasutajat: - „Pildiloome nõuab nanobanana-mcp serverit. Selle seadistamiseks käivita /blog image setup.“ - Kui seda kutsutakse sisemiselt (blog-write/blog-rewrite kaudu): naase vaikselt, viga ei teki. Kutsuv töövoog jätkab stokkfotodega.

Loomise töövoog

Käsu /blog image generate <idea> jaoks või sisemisel kutsumisel:

1. samm: Analüüsi kavatsust

Tee kindlaks, mida blogi vajab: - Pilditüüp: Kangelaspilt, tekstisisene, OG-kaart, jaotise eraldaja? - Blogi teema: Millest artikkel räägib? - Stiil: Fotorealistlik, toimetuslik, illustreeritud, minimalistlik? - Piirangud: Brändivärvid, konkreetsed mõõtmed, platvormi vorming? - Meeleolu: Autoriteetne, kutsuv, dramaatiline, puhas?

Kui päring on ebamäärane, küsi üks täpsustav küsimus kasutusjuhu ja stiili kohta.

2. samm: Vali valdkonnarežiim

Vali pildi jaoks ekspertiisilääts:

Laadi references/prompt-engineering-blog.md valdkonnarežiimi modifikaatorite teekide jaoks.

3. samm: Koosta 6-komponendiline arutlusülevaade

Ehita päring loomulike jutustavate lõikudena, mitte märksõnaloenditena:

1. Subjekt – kes/mis, rikkaliku füüsilise detailiga (tekstuurid, materjalid, mõõtkava)
2. Tegevus – mis toimub, poos, žest, liikumine, olek
3. Kontekst – keskkond, miljöö, kellaaeg, aastaaeg, ilm
4. Kompositsioon – kaameranurk, võttetüüp, kadreerimine, negatiivruum, sügavus
5. Valgus – valgusallikas, kvaliteet, suund, värvitemperatuur, varjud
6. Stiil – kunstimeedium, esteetika, filmilint, viidatud kunstnikud/ajastud

Mall fotorealistlike blogipiltide jaoks:

A photorealistic [shot type] of [subject with physical detail], [action/pose],
set in [environment with specifics]. [Lighting conditions] create [mood].
Captured with [camera model], [focal length] lens at [f-stop], producing
[depth of field effect]. [Color palette/grading notes]. Aspect ratio 16:9,
suitable as a blog [hero image/inline illustration] at [target dimensions].

Mall illustreeritud/stiliseeritud piltide jaoks:

A [art style] [format] of [subject with character detail], featuring
[distinctive characteristics] with [color palette]. [Line style] and
[shading technique]. Background is [description]. [Mood/atmosphere].

4. samm: Määra külgede suhe

Kutsu set_aspect_ratio ENNE loomist. Kasuta conversation_id: "default".

5. samm: Loo MCP kaudu

Mudeli valik: - Stabiilsed Google API ID-d: gemini-3.1-flash-image ja gemini-3-pro-image - Fikseeritud @ycse/nanobanana-mcp@1.1.1: set_model aktsepteerib flash ja pro, kuid vastendab need eelvaate ID-dega, mis suletakse 2026-06-25 - Kasuta otse API-d või uuemat MCP-paketti, mis toetab sõnaselgelt stabiilseid pildi ID-sid, enne kui lubada töötavat MCP-pildiloomet

Laadi references/mcp-tools.md parameetrite üksikasjade jaoks. Laadi references/gemini-models.md mudeli spetsifikatsioonide, hinnakirja ja päringupiirangute jaoks.

6. samm: Järeltöötlus (kui vaja)

Pärast loomist muuda suurust / teisenda blogi jaoks:

# Resize to blog hero dimensions (1200x630)
magick input.png -resize 1200x630^ -gravity center -extent 1200x630 hero.png

# Convert to WebP for web optimization
magick input.png -quality 85 output.webp

# Convert to AVIF when target browsers support it
magick input.png -quality 80 output.avif

# Crop to exact OG dimensions
magick input.png -resize 1200x630^ -gravity center -extent 1200x630 og-image.png

Kontrolli, kas magick (ImageMagick 7) on saadaval. Kui ei, kasuta varuvariandina convert.

7. samm: Tarni

Esita: 1. Pildi asukoht – kuhu see salvestati (~/Documents/nanobanana_generated/) 2. Koostatud päring – näita täielikku arutlusülevaadet (õpetlik) 3. Sätted – mudel, külgede suhe, valdkonnarežiim 4. Alt-tekst – kirjeldav lause, 10–125 märki, teema märksõnad loomulikult 5. Frontmatteri katkend (kangelas-/OG-piltide jaoks):

coverImage: "/path/to/generated-image.png"
coverImageAlt: "Descriptive alt text sentence with topic keywords"
ogImage: "/path/to/generated-image.png"

6. Viimistlusettepanekud – 1–2 ideed, kui asjakohane

Muutmise töövoog

Käsu /blog image edit <path> <instructions> jaoks:

1. Loe pildi asukoht ja muutmisjuhis
2. Täienda juhist (ära kunagi edasta töötlemata): | Kasutaja ütleb | Claude koostab | |-----------|---------------| | „eemalda taust“ | Detailne servi säilitav tausta eemaldamine | | „tee soojemaks“ | Konkreetne värvitemperatuuri nihe koos säilitamismärkustega | | „lisa tekst“ | Fondistiil, suurus, paigutus, kontrast, loetavuse märkused | | „tee heledamaks“ | Suurenda säritust, tõsta varjud, säilita heledaimad alad | | „kärbi sotsiaalmeedia jaoks“ | Muuda suuruseks 1200x630 keskpunkti-raskuspunktiga kärpega |
3. Kutsu gemini_edit_image koos täiendatud juhisega
4. Tagasta muudetud pildi asukoht ja kirjeldus

Sisemine API (blog-write / blog-rewrite jaoks)

Kui seda kutsutakse Task-alamagendina blog-write'ist või blog-rewrite'ist:

Sisend (annab kutsuv oskus): - image_type: hero, inline, og, divider - topic: blogipostituse teema/pealkiri - section_context: (valikuline) pealkiri või jaotis, mida pilt toetab - style_preference: (valikuline) fotorealistlik, illustreeritud, toimetuslik - count: (valikuline) vajalike piltide arv (vaikimisi: 1)

Väljund (tagastatakse kutsuvale oskusele):

### Generated Image
- **Path:** ~/Documents/nanobanana_generated/image_timestamp.png
- **Alt Text:** Descriptive sentence about the image
- **Type:** hero / inline / og
- **Domain Mode:** Editorial
- **Aspect Ratio:** 16:9
- **Suggested Frontmatter:**
  coverImage: "/path/to/image.png"
  coverImageAlt: "Alt text here"

Sujuv varuvariant: Kui MCP pole saadaval, naase kohe ilma veata. Kutsuv töövoog jätkab stokkfotodega. Ära kunagi blokeeri blog-write'i ega blog-rewrite'i seetõttu, et pildiloome pole saadaval.

Alt-teksti loomine

Iga loodud pildi jaoks loo alt-tekst, järgides blogistandardeid: - Täislause kirjeldus (mitte märksõnaloend) - 10–125 märki - Lisa teema märksõnad loomulikult - Kirjelda, mida pilt näitab JA selle seotust sisuga - Graafikute/infograafika puhul: lisa peamine andmepunkt

Hea: Marketing team analyzing AI search traffic data on a dashboard showing citation metrics Halb: SEO AI marketing blog optimization image

Seadistamine

Käsu /blog image setup jaoks:

1. Käivita python3 skills/blog-image/scripts/setup_image_mcp.py (interaktiivne) - Eelista: GOOGLE_AI_API_KEY=... python3 skills/blog-image/scripts/setup_image_mcp.py - Või: python3 skills/blog-image/scripts/setup_image_mcp.py --key-file /path/to/key.txt - Väldi --key, kui pole vajalik, sest käsuargumendid võivad sattuda shelli ajalukku ja protsessiloenditesse - Vaikimisi kirjutab ~/.claude/settings.json-i (kasutaja-privaatne, režiim 0600) - Lipp --project valib projekti .mcp.json (ainult keskkonna laiendamine, keeldub literaalse võtme kirjutamisest jälgitavasse faili)
2. Kontrolli: python3 skills/blog-image/scripts/validate_image_setup.py
3. Nõuab: - Node.js 18+ (npx) - Google AI API-võti, tasuta luua aadressil https://aistudio.google.com/apikey - Pildimudelite jaoks võib olla vajalik arveldamisega projekt
4. Skript fikseerib paketi versiooniks @ycse/nanobanana-mcp@1.1.1. See npm-i väljaanne kodeerib kõvasti eelvaate pildimudeli ID-d, mis suletakse 2026-06-25. Uuenda seadistus, valideerimine ja see dokumentatsioon koos, kui on saadaval stabiilse ID toega paketiväljaanne.

Turvafiltri automaatne ümbersõnastamine

Kui tagastatakse IMAGE_SAFETY või SAFETY, ÄRA anna alla. Sõnasta automaatselt ümber ja proovi uuesti:

1. Tuvasta tõenäoline päästik (vägivald, avaliku elu tegelased, NSFW-lähedane või liiga ettevaatlik filter)
2. Sõnasta ümber positiivse raamistusega – kirjelda, mida SOOVID, mitte mida vältida
3. Kui subjekt on inimene, muuda ta üldiseks (eemalda kuulsusele omased detailid)
4. Kui stseen on dramaatiline, pehmenda: „intensiivne“ → „keskendunud“, „lahing“ → „võistlus“
5. Proovi uuesti ümbersõnastatud päringuga (enne kasutajale teatamist kuni 3 katset)

Google tunnistas, et filtrid „muutusid palju ettevaatlikumaks, kui me kavatsesime“ – kahjutuid päringuid blokeeritakse mõnikord. Ümbersõnastamisega järjekindlus tavaliselt õnnestub.

Muuda, ära loo uuesti

Kui pilt on 80% õige, kasuta gemini_chat-i vestluspõhiseks muutmiseks, selle asemel et luua see nullist uuesti. Seanss säilitab stiili järjepidevuse, nii et sihitud muudatused säilitavad selle, mis töötab, parandades seda, mis ei tööta.

Millal muuta vs. uuesti luua: - Värv veidi paigast ära → Muuda („nihuta värvitemperatuur soojemaks“) - Täiesti vale kompositsioon → Loo uuesti muudetud ülevaatega - Hea stseen, kuid vale valgus → Muuda („vaheta vasakult tuleva kuldtunni valguse vastu“) - Puudub detail → Muuda („lisa lauale aurav kohvitass“)

Vigade käsitlemine

Viitedokumentatsioon

Laadi vajaduspõhiselt – ÄRA laadi kõike käivitamisel: - references/prompt-engineering-blog.md – valdkonnarežiimid, 6-komponendiline süsteem, blogimallid - references/gemini-models.md – mudeli spetsifikatsioonid, päringupiirangud, külgede suhted, hinnakiri - references/mcp-tools.md – MCP-tööriistade parameetrid ja vastuste vormingud