# Gemini Image Generation Status

**Last Updated:** 2026-04-10  
**Status:** ✅ **WORKING** (when `GEMINI_API_KEY` or `v2/config/gemini-api-key.php` is configured)

## Summary

The Gemini image generation workflow is **fully functional** when a valid Gemini Developer API key is set. Resolution matches [GEMINI_API_KEY_LOCAL.md](../../development/GEMINI_API_KEY_LOCAL.md) (`gemini_api_key.py` + `ordio_get_gemini_api_key()`).

## Current Configuration

- **API key:** `GEMINI_API_KEY` (env / `.env`) and/or `v2/config/gemini-api-key.php`
- **PHP:** `ordio_get_gemini_api_key()` in `v2/config/ai-faq-config.php` (no Google Maps fallback)

## Verification

```bash
python3 v2/scripts/nano-ai/check-gemini-quota.py
python3 v2/scripts/blog/generate-blog-featured-image.py --post=mentoring --category=lexikon --dry-run
```

## Standard Workflow

```bash
# 1. Create/update IMAGE_PROMPT.md with ## Prompt section
# 2. Generate image:
python3 v2/scripts/blog/generate-blog-featured-image.py --post=slug --category=lexikon

# 3. Script automatically:
#    - Reads prompt from IMAGE_PROMPT.md
#    - Generates PNG using Gemini API
#    - Converts to WebP variants (640w, 1024w, 1280w)
#    - Updates post JSON with srcset
```

## Related Documentation

- [GEMINI_API_KEY_LOCAL.md](../../development/GEMINI_API_KEY_LOCAL.md) — create key, restrict API, rotation
- [GEMINI_IMAGE_GENERATION_WORKFLOW.md](GEMINI_IMAGE_GENERATION_WORKFLOW.md) — complete workflow guide
- [BLOG_FEATURED_IMAGE_GENERATION.md](BLOG_FEATURED_IMAGE_GENERATION.md) — technical details
- [BLOG_FEATURED_IMAGE_STYLE_GUIDE.md](BLOG_FEATURED_IMAGE_STYLE_GUIDE.md) — style guidelines