SuperAPI AI Directory

image-illustration-upload

Design & creation

View repository

Updated 10-15 19:54

About this skill

Image selection and upload

Professional capability to automatically generate images for WeChat 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 "add images now", "help me add images", "add pictures"
  • After article review and proofreading is completed, an image selection need is mentioned
  • Article content is detected as complete but lacking images

Core Features

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

Image Quantity Guidelines

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

Image Placement Strategy

Required Image Placements:

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

Optional Image Placements:

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

Image Source Priority

1️⃣ Public domain works (highest priority)

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

2️⃣ AI-generated (recommended)

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

3️⃣ Free stock libraries

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

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

  • Source: YouTube, Bilibili, product official websites, movie posters
  • Applicable: Case images (product screenshots, video screenshots)
  • Note: Cite the source, fair use principle
  • Operation: Remind the user to take screenshots themselves, or generate AI concept images as a substitute

Image Host Upload Process

Core Scripts

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

Upload Methods

# 调用上传脚本(在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

  • ✅ Prefer uploading to ImgBB image hosting (permanently valid)
  • ⚠️ If upload fails, automatically use the original link as fallback
  • 📌 See /tools/README.md - Image Upload Script Instructions

Markdown Insertion Format

![图片描述](https://i.ibb.co/xxxxx/image.jpg)
  • Use permanent web links (not local paths)
  • Fill in meaningful image descriptions (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 links:https://i.ibb.co/xxxxx/image.jpg(recommended, permanently valid)
  • ❌ Local paths: no longer use local paths (they will become invalid when copied to WeChat Official Account)

Copyright Notes

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

Image Checklist

Before executing the image task, confirm the following:

  • The article has been reviewed and the content is stable
  • Determine the number of images (5-8)
  • Determine image positions (header image + core sections)
  • All images have been obtained (AI-generated/public domain/free stock)
  • All images have been uploaded to ImgBB image hosting
  • Image links are permanent web links (starting with https://)
  • Images have been inserted in Markdown (using web links)
  • Image descriptions (alt text) have been filled in
  • All image links have been verified (accessible 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 requirement checklist (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 retrieval
  2. AI-generated → call API to generate
  3. Free stock → WebFetch search
  4. Screenshot materials → remind the user to provide them

Step 3: Upload to image hosting and obtain permanent links

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

Step 4: Insert images into the article

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

Step 5: Verify 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 Instructions
  • /公众号写作/images/useless-content/配图Best Practice总结.md - Image Best Practices

Common Questions

Q1: Will temporary links to AI-generated images become invalid?

A: Yes. Therefore, you must callupload_image.pyUpload to ImgBB to obtain a permanent link.

Q2: What should I do if image hosting 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: Does every article need to include images?

A: Images are recommended, especially for long articles (over 3000 words). However, short articles (under 1000 words) can include only a title image.

Q4: Can local image paths be used?

A: Not recommended. Local paths become invalid after being copied into the WeChat official account editor, so web links must be used.

Technical Dependencies

  • Python script: /tools/upload_image.py(already available)
  • API configuration: ImgBB API key (already configured in ~/.zshrc)
  • AI generation API: Volcano Engine doubao-seedream (optional)
  • Tool: WebFetch (to obtain public domain images)

Success Cases

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

Last updated: 2025-11-07 Applicable project: WeChat official account writing Maintainer: 花生