ImageGenerator

KO | EN

gitlite — search

#markdown #framework #kubernetes #list #c #ui #devops #http #android #developer-tools

(★ 9)

ImageGenerator by Uncle Engineer

File Explorer

ZIP Download

image_generator.py
README.md
requirements.txt
SCREEN_SHOT1.png
SCREEN_SHOT2.png

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

โปรแกรมสร้างภาพด้วย AI ผ่าน [OpenRouter](https://openrouter.ai) หน้าตาเป็นโปรแกรมเดสก์ท็อป (Tkinter)
เลือกได้ทุกโมเดลสร้างภาพที่ OpenRouter มี บันทึกภาพลงโฟลเดอร์ให้อัตโนมัติ
เก็บประวัติพร้อม prompt และสรุปค่าใช้จ่ายให้ดูย้อนหลังได้

![หน้าตาโปรแกรม](https://raw.githubusercontent.com/UncleLabsBlacksmith/ImageGenerator/main/SCREEN_SHOT1.png)

---

## ความสามารถ

- เลือกโมเดลสร้างภาพได้ทุกตัวของ OpenRouter (ดึงรายการสดจาก API)
- เพิ่มโมเดลเองได้ ถ้ามีตัวใหม่ที่ยังไม่ขึ้นในรายการ
- ช่องตั้งค่าปรับตามโมเดล — โมเดลไหนรองรับอะไร ช่องนั้นถึงจะใช้ได้
- บันทึกภาพลงโฟลเดอร์ `outputs/` อัตโนมัติทุกครั้งที่สร้าง
- ประวัติการสร้างภาพ พร้อมรูปย่อ + prompt + ต้นทุนต่อภาพ กดย้อนกลับมาใช้ prompt เดิมได้
- แดชบอร์ดสรุปค่าใช้จ่าย ทั้งยอดรวมและแยกตามโมเดล กรองตามวันที่ ส่งออก CSV ได้
- ตั้งค่า API key ได้ในโปรแกรมเลย ไม่ต้องแก้ไฟล์เอง

---

## 1. ติดตั้ง Python ก่อน

โปรแกรมนี้ใช้ Python (แนะนำ 3.9 ขึ้นไป)

เช็กว่ามีแล้วหรือยัง เปิด Command Prompt (Windows) หรือ Terminal แล้วพิมพ์:

```bash
python --version
```

ถ้าขึ้นเลขเวอร์ชัน เช่น `Python 3.12.0` แปลว่ามีแล้ว ข้ามไปข้อ 2 ได้เลย
ถ้าไม่ขึ้น ให้โหลดจาก [python.org/downloads](https://www.python.org/downloads/)

> **สำคัญสำหรับ Windows:** ตอนติดตั้ง ให้ติ๊ก **Add Python to PATH** ที่หน้าจอแรกด้วย
> ไม่งั้นจะสั่ง `python` จาก Command Prompt ไม่ได้

**Linux เพิ่มอีกนิด** — ต้องลง tkinter ด้วย (Windows / macOS มีมาให้แล้ว):

```bash
sudo apt install python3-tk
```

---

## 2. ติดตั้งแพ็กเกจที่ต้องใช้

```bash
pip install requests python-dotenv pillow
```

หรือใช้ไฟล์ในโปรเจกต์นี้:

```bash
pip install -r requirements.txt
```

| แพ็กเกจ | ใช้ทำอะไร |
|---|---|
| `requests` | เรียก API ของ OpenRouter |
| `python-dotenv` | อ่าน API key จากไฟล์ `.env` |
| `pillow` | เปิด ย่อ และแสดงรูปภาพ |

ถ้าในเครื่องมี Python หลายเวอร์ชัน ให้สั่งแบบนี้แทน:

```bash
py -m pip install requests python-dotenv pillow
```

> ถ้าลืมติดตั้ง ก็เปิดโปรแกรมได้เลย — จะมีหน้าต่างบอกว่าขาดตัวไหน
> พร้อมคำสั่งติดตั้งที่กดปุ่มคัดลอกได้

---

## 3. เปิดโปรแกรม

```bash
python image_generator.py
```

---

## 4. ตั้งค่า API Key (ทำครั้งเดียว)

โปรแกรมใช้เครดิตในบัญชี OpenRouter ของคุณ จึงต้องมี API key ก่อน

1. สมัครและเติมเครดิตที่ [openrouter.ai](https://openrouter.ai)
2. ไปที่ [openrouter.ai/keys](https://openrouter.ai/keys) กด **Create Key** ตั้งชื่ออะไรก็ได้
3. คัดลอก key ที่ขึ้นต้นด้วย `sk-or-v1-...` (เว็บจะโชว์เต็มแค่ครั้งเดียว เก็บไว้ให้ดี)
4. ในโปรแกรม ไปที่เมนู **ตั้งค่า → ตั้งค่า API Key...**
5. วาง key ลงช่อง → กด **ทดสอบ key** (จะบอกเครดิตคงเหลือ) → กด **บันทึก**

ใช้งานได้ทันที ไม่ต้องปิดเปิดโปรแกรมใหม่

**ถ้าอยากตั้งเอง** ก๊อปไฟล์ตัวอย่าง `.env_ex` มาเปลี่ยนชื่อเป็น `.env`
(หรือสร้างไฟล์ชื่อ `.env` ไว้ข้างๆ `image_generator.py`) แล้วใส่บรรทัดเดียว:

```
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx
```

> ⚠️ **อย่าอัปโหลดไฟล์ `.env` ขึ้น GitHub** เพราะใครก็ตามที่ได้ key ไปจะใช้เครดิตของคุณได้
> ไฟล์ `.gitignore` ในโปรเจกต์นี้กันไว้ให้แล้ว

อยากเช็กยอดใช้จ่ายเมื่อไหร่ก็ได้ที่เมนู **ตั้งค่า → ตรวจสอบ API Key ปัจจุบัน**

---

## 5. วิธีใช้งาน

1. **เลือกโมเดล** จากช่องด้านบน (พิมพ์ในช่อง "กรอง" เพื่อค้นหา เช่น `flux`, `seedream`)
   ข้างชื่อโมเดลจะบอกราคาต่อภาพให้ด้วย
2. **พิมพ์ prompt** ในช่อง Prompt (ภาษาไทยหรืออังกฤษก็ได้ แต่อังกฤษมักได้ผลดีกว่า)
3. **ตั้งค่าพารามิเตอร์** เท่าที่ต้องการ — ช่องที่โมเดลนั้นไม่รองรับจะเป็นสีเทากดไม่ได้
   ปล่อยเป็น `— ไม่ส่ง —` ไว้ก็ได้ จะใช้ค่าเริ่มต้นของโมเดล
4. กดปุ่ม **▶ สร้างภาพ** หรือ **Ctrl + Enter**
5. ภาพจะถูกบันทึกลงโฟลเดอร์ `outputs/` ให้อัตโนมัติ พร้อมขึ้นในประวัติทางซ้าย

### เพิ่มโมเดลเอง

ถ้ามีโมเดลใหม่ที่ยังไม่ขึ้นในรายการ พิมพ์ชื่อรุ่นเต็มลงช่อง **เพิ่มเอง** เช่น
`bytedance-seed/seedream-5-0-pro` แล้วกด **+ เพิ่ม** โมเดลจะถูกจำไว้ให้ (มีดาว ★ นำหน้า)

### ประวัติ (แถบซ้าย)

- คลิกรายการ = ดูภาพเดิม
- ดับเบิลคลิก หรือกด **ใช้ prompt นี้** = ดึง prompt กับค่าเดิมกลับมาใช้
- คลิกขวา = เปิดไฟล์ / เปิดที่ตั้งไฟล์ / คัดลอก prompt / ลบ
- ช่อง **ค้นหา** ใช้หาจากข้อความใน prompt หรือชื่อโมเดล

### แดชบอร์ดค่าใช้จ่าย

![แดชบอร์ดค่าใช้จ่าย](https://raw.githubusercontent.com/UncleLabsBlacksmith/ImageGenerator/main/SCREEN_SHOT2.png)

กดปุ่ม **แดชบอร์ดค่าใช้จ่าย** มุมซ้ายบน จะเห็น

- ยอดรวม / จำนวนภาพ / จำนวนครั้ง / เฉลี่ยต่อภาพ / โมเดลที่ใช้เงินมากสุด
- กราฟค่าใช้จ่ายตามวัน
- ตารางแยกตามโมเดล พร้อมสัดส่วน %
- กรองช่วงวันที่ได้ (มีปุ่มลัด วันนี้ / 7 วัน / 30 วัน / 90 วัน / ทั้งหมด)
- กด **ส่งออก CSV** เอาไปเปิดใน Excel ต่อได้

> ตัวเลขที่มีเครื่องหมาย `~` คือค่าประมาณจากราคาป้ายของโมเดล (กรณี API ไม่ได้ส่งค่าใช้จ่ายจริงกลับมา)

---

## ไฟล์ที่โปรแกรมสร้างขึ้น

| ที่อยู่ | เก็บอะไร |
|---|---|
| `outputs/` | ไฟล์ภาพทั้งหมดที่สร้าง |
| `data/history.json` | ประวัติ prompt + ต้นทุน + ที่อยู่ไฟล์ |
| `data/settings.json` | โมเดลล่าสุด โฟลเดอร์บันทึก โมเดลที่เพิ่มเอง |
| `data/thumbs/` | รูปย่อสำหรับแสดงในตารางประวัติ |
| `data/models_cache.json` | แคชรายการโมเดล (เปิดโปรแกรมครั้งถัดไปจะไวขึ้น) |
| `data/pricing_cache.json` | แคชราคาต่อภาพของแต่ละโมเดล |
| `.env` | API key ของคุณ (**ห้ามแชร์**) — มีตัวอย่างให้ที่ `.env_ex` |

ลบทิ้งได้ทั้งหมดถ้าอยากเริ่มใหม่ โปรแกรมจะสร้างให้เองรอบหน้า

---

## ปัญหาที่พบบ่อย

| อาการ | วิธีแก้ |
|---|---|
| `'python' is not recognized` | ติดตั้ง Python ใหม่แล้วติ๊ก *Add Python to PATH* หรือลองใช้ `py` แทน `python` |
| `ModuleNotFoundError: No module named 'requests'` | ยังไม่ได้ติดตั้งแพ็กเกจ ดูข้อ 2 |
| เปิดแล้วขึ้นหน้าต่าง "ยังติดตั้งแพ็กเกจไม่ครบ" | กดปุ่มคัดลอกคำสั่งในหน้าต่างนั้นไปรันได้เลย |
| ขึ้น `401` หรือ "key ไม่ถูกต้อง" | key ผิดหรือถูกยกเลิก สร้างใหม่แล้วตั้งค่าที่เมนู ตั้งค่า |
| สร้างภาพแล้วขึ้นว่าเครดิตไม่พอ | เติมเครดิตที่ openrouter.ai |
| รอนานแล้ว timeout | ลองใหม่ หรือเปลี่ยนไปโมเดลที่เร็วกว่า / ลด Resolution |
| ช่อง Resolution กดไม่ได้ | โมเดลนั้นไม่รองรับ ลองเปลี่ยนโมเดล หรือติ๊ก "ปลดล็อกพารามิเตอร์ทั้งหมด" |

---

## หมายเหตุ

- ค่าใช้จ่ายคิดตามราคาของแต่ละโมเดลบน OpenRouter โดยตรง โปรแกรมนี้ไม่มีค่าใช้จ่ายเพิ่ม
- ตรวจสอบเงื่อนไขการใช้งานภาพที่สร้างได้จากผู้ให้บริการโมเดลนั้นๆ

อยากเรียนวิชาล้ำๆกับลุง เข้ามา sponsor สมัครเรียนได้ใน https://uncle-engineer.com/

ImageGenerator

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README