Image Illustration and Upload
Professional capability for automatically generating illustrations for official account articles, uploading to image hosting, and inserting Markdown links.
When to Use This Skill
Automatically load this skill when detecting the following scenarios:
- User says "generate illustration now", "help me create illustrations", "add images"
- Illustration needs are mentioned after article review is completed
- Article content is complete but lacks images
Core Features
- Analyze Illustration Requirements: Determine 5-8 illustrations needed based on article content
- Obtain Image Sources:
- Public domain works (Wikimedia Commons, Google Arts & Culture)
- AI-generated images (Volcano Engine doubao-seedream API)
- Free image libraries (Unsplash, Pexels)
- Auto-upload to Image Hosting: Call ImgBB image hosting to get permanent links
- Insert into Markdown: Insert image links at corresponding positions in the article
- Validation & Display: Ensure all image links are valid
Illustration Quantity Specifications
- Recommended: 5-8 images
- Minimum: 3 images (cover image + 2 body images)
- Maximum: No more than 10 images (avoid excessive reading interruption)
Illustration Placement Strategy
Mandatory Placements:
- ✅ Cover image: Below the title, required
- ✅ Core chapters: 1 image per key chapter
Optional Placements:
- Theoretical support (e.g., citing classic works)
- Data visualization (comparison charts, graphs)
- Case supplements (product screenshots, examples)
Image Source Priority
1️⃣ Public Domain Works (Highest Priority)
- Sources: Wikimedia Commons, Google Arts & Culture
- Applicable: Classic artworks, historical portraits, ancient book covers
- Advantages: Free, no copyright issues, high quality
- Examples: Van Gogh's Starry Night, portrait of Kant
- Operation: Use WebFetch to get Wikimedia Commons image links
2️⃣ AI Generation (Recommended)
- Source: Volcano Engine doubao-seedream-4-0-250828
- Applicable: Cover images, concept maps, abstract themes
- Advantages: Original, customizable, fast
- Operation: Call API to generate images and return temporary URLs
3️⃣ Free Image Libraries
- Sources: Unsplash, Pexels, Pixabay
- Applicable: Cover images, concept maps, background images
- Advantages: Free, high quality, commercially usable (CC0)
- Operation: WebFetch search + download
4️⃣ Screenshots/Official Materials (Must Cite Source)
- Sources: YouTube, Bilibili, official product websites, movie posters
- Applicable: Case images (product screenshots, video screenshots)
- Note: Cite the source, follow fair use principles
- Operation: Remind users to provide screenshots themselves, or generate AI concept images as alternatives
Image Hosting Upload Process
Core Script
Use the existing
script in the project
Upload Methods
python
# Call upload script (in Bash)
python3 /Users/alchain/Documents/写作/tools/upload_image.py <image URL or local path>
# Process web images (e.g., temporary links from AI generation)
python3 /Users/alchain/Documents/写作/tools/upload_image.py "https://example.com/ai-generated.jpg"
# Process local images
python3 /Users/alchain/Documents/写作/tools/upload_image.py "/Users/alchain/Pictures/image.png"
# Script automatically returns permanent ImgBB link
Fault Tolerance Mechanism
- ✅ Prioritize uploading to ImgBB (permanently valid)
- ⚠️ Automatically use original link as fallback if upload fails
- 📌 See - Image Upload Script Instructions
Markdown Insert Format
markdown
- Use permanent web links (not local paths)
- Fill in meaningful image descriptions (alt text)
- Keep image descriptions concise and highlight content
Image Specifications
Size Specifications
- Cover image: 1200x600px (16:9)
- Body image: 800-1200px wide
- Character/Product: 800x800px (1:1)
File Specifications
- Format: JPG (photos) / PNG (illustrations)
- Size: < 500KB
- Naming: lowercase, semantic, English (e.g., , )
Path Specifications
- ✅ Web link:
https://i.ibb.co/xxxxx/image.jpg
- ❌ Local path: No longer use local paths (will fail when copied to official account editor)
Copyright Notes
- ✅ Public domain works (author has been deceased for over 70 years)
- ✅ CC0-licensed images (Unsplash, etc.)
- ✅ AI-generated images (confirm tool license)
- ⚠️ Screenshots/official materials must cite sources
Illustration Checklist
Confirm the following before executing illustration tasks:
Execution Steps (5-Step Standard Process)
Step 1: Analyze Article, Determine Illustration Requirements
- Read the full article, mark key chapters
- List illustration requirement checklist (6-8 items)
- Determine position and purpose of each image
Step 2: Obtain/Generate Images
Obtain images according to source priority:
- Public domain works → Fetch via WebFetch
- AI-generated → Call API to generate
- Free image libraries → Search via WebFetch
- Screenshot materials → Remind users to provide
Step 3: Upload to Image Hosting, Get Permanent Links
bash
# Call upload script for each image
python3 /Users/alchain/Documents/写作/tools/upload_image.py <image URL>
Step 4: Insert Images into Article
markdown
Step 5: Validate Display
bash
# Check all image references
grep -n "!\[" "article-path.md"
# All image links should be web links starting with https://
Reference Resources
- - Image Upload Script Instructions
- - Image Upload Script
- - AI Image Generation API Instructions
/公众号写作/images/useless-content/配图Best Practice总结.md
Frequently Asked Questions
Q1: Will temporary links of AI-generated images expire?
A: Yes. So you must call
to upload to ImgBB and get permanent links.
Q2: What if image hosting upload fails?
A: The script has a fault tolerance mechanism and will automatically fallback to the original URL. But it's recommended to check ImgBB API configuration.
Q3: Is it mandatory to add illustrations to every article?
A: Recommended, especially for long articles (over 3000 words). Short articles (under 1000 words) can only have a cover image.
Q4: Can I use local image paths?
A: Not recommended. Local paths will fail when copied to official account editors, so web links must be used.
Technical Dependencies
- Python Script: (existing)
- API Configuration: ImgBB API key (configured in )
- AI Generation API: Volcano Engine doubao-seedream (optional)
- Tool: WebFetch (obtain public domain images)
Success Cases
- 《Why the Best Content is Useless》: 6 illustrations (2 public domain + 4 AI-generated)
- 《DeepSeek-OCR In-depth Evaluation》: 5 illustrations, all uploaded to ImgBB, no issues when copied to official account
Last Updated: 2025-11-07
Applicable Project: Official Account Writing
Maintainer: Huasheng
Produced by Uncle Hua | AI Native Coder · Independent Developer
Official Account "Uncle Hua" | 300k+ Followers | AI Tools & Efficiency Improvement
Masterpieces: Kitten Fill Light (Top 1 in AppStore Paid List) · Mastering DeepSeek in One Book