SuperAPI AI Directory

huashu-image-upload

Office & productivity

View repository

Updated 10-15 16:22

About this skill

Image Illustration and Upload

Professional capability to automatically generate illustrations for official account articles, upload them to an image hosting service, and insert Markdown links.

When to Use This Skill

When the following scenarios are detected, automatically load this skill:

  • The user says "illustrate now", "help me add illustrations", or "add images"
  • A need for illustrations is mentioned after article proofreading is completed
  • Article content is detected as complete but lacking images

Core Features

  1. Analyze illustration needs: Determine the need for 5-8 illustrations based on article content
  2. Obtain image sources:
    • Public domain works (Wikimedia Commons, Google Arts & Culture)
    • AI-generated images (Volcano Engine doubao-seedream API)
    • Free image libraries (Unsplash, Pexels)
  3. Automatically upload to image hosting service: Call the ImgBB image hosting service to obtain permanent links
  4. Insert Markdown: Insert image links at the corresponding positions in the article
  5. Verify display: Ensure all image links are valid

Illustration Quantity Guidelines

  • Recommended: 5-8 images
  • Minimum: 3 images (header image + 2 body images)
  • Maximum: No more than 10 images (to avoid excessively interrupting reading)

Illustration Placement Strategy

Required Illustration Positions:

  • ✅ Header image (cover image): Below the title, required
  • ✅ Core sections: 1 image for each key section

Optional Illustration Positions:

  • Theoretical support (e.g., citing classic works)
  • Data visualization (comparison charts, charts)
  • Case supplementation (product screenshots, examples)

Image Source Priority

1️⃣ Public domain works (highest priority)

  • Source:Wikimedia Commons、Google Arts & Culture
  • Applicable to: Classic artworks, portraits of historical figures, covers of ancient books
  • Advantages: Free, no copyright issues, high quality
  • Examples: Van Gogh's "The Starry Night", portrait of Kant
  • Operation: Use WebFetch to obtain Wikimedia Commons image links

2️⃣ AI-generated (recommended)

  • Source: Volcano Engine doubao-seedream-4-0-250828
  • Applicable to: Header images, concept images, abstract themes
  • Advantages: Original, customizable, fast
  • Operation: Call the API to generate images and return temporary URLs

3️⃣ Free image libraries

  • Source:Unsplash、Pexels、Pixabay
  • Applicable to: Header images, concept images, background images
  • Advantages: Free, high quality, commercially usable (CC0)
  • Operation: WebFetch search + download

4️⃣ Screenshots/official assets (source must be cited)

  • Source: YouTube, Bilibili, product official websites, movie posters
  • Applicable to: Case images (product screenshots, video screenshots)
  • Note: Indicate the source, principles of fair use
  • Action: Remind the user to take their own screenshots, or generate an AI concept image as a substitute

Image Hosting Upload Process

Core Script

Use the project's existing /tools/upload_image.py script

Upload Method

# 调用上传脚本(在Bash中)
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL或本地路径>

# 处理网络图片(如AI生成的临时链接)
python3 /Users/alchain/Documents/写作/tools/upload_image.py "https://example.com/ai-generated.jpg"

# 处理本地图片
python3 /Users/alchain/Documents/写作/tools/upload_image.py "/Users/alchain/Pictures/image.png"

# 脚本自动返回ImgBB永久链接

Fault-Tolerance Mechanism

  • ✅ Upload preferentially to the ImgBB image host (permanently valid)
  • ⚠️ If the upload fails, automatically use the original link as a fallback
  • 📌 See /tools/README.md - Image upload script documentation

Markdown Insertion Format

![图片描述](https://i.ibb.co/xxxxx/image.jpg)
  • Use a permanent web link (not a local path)
  • Fill in a meaningful image description (alt text)
  • Image descriptions should be concise and highlight the image content

Image Specifications

Size Specifications

  • Cover image: 1200x600px (16:9)
  • Body image: 800-1200px wide
  • People/Products: 800x800px (1:1)

File Specifications

  • Format: JPG (photos) / PNG (illustrations)
  • Size: < 500KB
  • Naming: lowercase, semantic, English (e.g., mrbeast.jpg, starry-night.jpg)

Path Specifications

  • ✅ Web link:https://i.ibb.co/xxxxx/image.jpg(recommended, permanently valid)
  • ❌ Local path: no longer use local paths (they will break when copied to WeChat Official Accounts)

Copyright Notice

  • ✅ Public domain works (author died more than 70 years ago)
  • ✅ CC0-licensed images (Unsplash, etc.)
  • ✅ AI-generated images (confirm the tool's license)
  • ⚠️ Screenshots/official materials must indicate the source

Image Checklist

Before carrying out the image task, confirm the following:

  • The article has been proofread and the content is stable
  • Determine the number of images (5-8)
  • Determine the image positions (title image + core sections)
  • All images have been obtained (AI-generated/public domain/free stock)
  • All images have been uploaded to the ImgBB image host
  • The image links are permanent web links (starting with https://)
  • Images have been inserted into the Markdown (using web links)
  • Image descriptions (alt text) have been filled in
  • All image links have been verified (they can be accessed normally)

Execution Steps (5-step standard process)

Step 1: Analyze the article and determine image requirements

  • Read through the full text and mark key sections
  • List the image requirements (6-8 items)
  • Determine the position and role of each image

Step 2: Obtain/Generate images

Obtain images according to the image source priority:

  1. Public domain works → WebFetch
  2. AI-generated → call the API to generate
  3. Free stock libraries → WebFetch search
  4. Screenshot materials → remind the user to provide them

Step 3: Upload to the image host and obtain a permanent link

# 对每张图片调用上传脚本
python3 /Users/alchain/Documents/写作/tools/upload_image.py <图片URL>

Step 4: Insert the images into the article

![图片描述](https://i.ibb.co/xxxxx/image.jpg)

Step 5: Verify the display

# 检查所有图片引用
grep -n "!\[" "文章路径.md"
# 所有图片链接应该是 https:// 开头的网络链接

Reference Resources

  • /tools/README.md - Instructions for using the image upload script
  • /tools/upload_image.py - Image upload script
  • /公众号写作/AI文生图API调用.md - AI text-to-image API documentation
  • /公众号写作/images/useless-content/配图Best Practice总结.md - Best practices for images

Frequently Asked Questions

Q1: Will temporary links for AI-generated images expire?

A: Yes. So you must callupload_image.pyUpload to ImgBB to get a permanent link.

Q2: What should I do if the image host upload fails?

A: The script has a fault-tolerance mechanism and will automatically fall back to the original URL. However, it is recommended to check the ImgBB API configuration.

Q3: Must every article include images?

A: Images are recommended, especially for long articles (over 3,000 characters). But short articles (under 1,000 characters) can include only a header image.

Q4: Can local image paths be used?

A: Not recommended. Local paths will become invalid after being copied to the WeChat Official Account editor, so web links must be used.

Technical Dependencies

  • Python Script: /tools/upload_image.py(Existing)
  • API Configuration: ImgBB API key (already configured in ~/.zshrc)
  • AI Generation API: Volcano Engine doubao-seedream (optional)
  • : WebFetch (to obtain public domain images): WebFetch (to obtain public domain images)

Success Cases

  • "Why the Best Content Is Useless": 6 images (2 public domain + 4 AI-generated)
  • "DeepSeek-OCR In-Depth Review": 5 images, all uploaded to ImgBB, no pressure when copied to the WeChat Official Account

Last Updated: 2025-11-07 Applicable Project: WeChat Official Account writing : 花生: 花生


Produced by 花叔 | AI Native Coder · Indie Developer WeChat Official Account "花叔" | 300k+ followers | AI tools and productivity improvement Representative work: 小猫补光灯 (AppStore paid chart Top1) · "一本书玩转DeepSeek"