Tạo hình ảnh thương mại điện tử sẵn sàng cho nền tảng với Agent Skills của GPT Image 2.5

Ecommerce Image Skills làm được gì

Ecommerce Image Skills là bộ sưu tập gồm 12 Agent Skill có thể cài đặt, giúp biến một bức ảnh sản phẩm thông thường thành hình ảnh thương mại điện tử sẵn sàng cho từng nền tảng. Các skill hoạt động với Claude Code, Codex, Cursor hoặc bất kỳ agent nào có thể đọc tệp SKILL.md.

Thay vì phải duy trì một bộ sưu tập lớn các prompt rời rạc, mỗi skill kết hợp hướng dẫn nhận diện sản phẩm, thông số kỹ thuật của nền tảng, định tuyến mô hình và các script tùy chọn cho những tác vụ xử lý hình ảnh có tính xác định. Bạn có thể tạo ảnh chính cho Amazon, bối cảnh lifestyle, infographic, module A+, bảng kích thước, ảnh người mẫu mặc thử, banner khuyến mãi, ảnh bìa Xiaohongshu và trang chi tiết Taobao.

Kho mã hỗ trợ các mô hình GPT Image 2.5: gpt-image-2.5-flare để tạo bối cảnh và bố cục nhanh, cùng gpt-image-2.5-sunburst khi cần chú trọng hơn đến văn bản, logo, nhãn hoặc chỉnh sửa cục bộ.

Tính năng chính

• Khóa nhận diện sản phẩm: mỗi skill trước tiên ghi nhận hình dáng, màu sắc, logo và văn bản trên sản phẩm, sau đó đưa các chi tiết này vào prompt được tạo.
• Thông số nền tảng tích hợp: bao gồm nền trắng #FFFFFF và yêu cầu độ phủ sản phẩm tối thiểu của Amazon, trang chi tiết Taobao rộng 750 pixel, ảnh bìa Xiaohongshu tỷ lệ 3:4, kích thước module A+ và định dạng banner của các nền tảng.
• Định tuyến mô hình: Flare là lựa chọn mặc định cho bối cảnh, nền, bố cục và các biến thể nhanh. Sunburst được khuyến nghị cho logo, văn bản nhỏ, ảnh chính hoàn thiện và chỉnh sửa cục bộ.
• Script có tính xác định: các script đi kèm có thể kiểm tra và sửa nền trắng, cắt ảnh A+, tạo lưới, ghép và chia ảnh chi tiết dài, đồng thời xử lý hàng loạt với khả năng thử lại, tiếp tục, ghi nhật ký và giới hạn ngân sách.
• Ba phương thức tạo ảnh: sử dụng công cụ hình ảnh tích hợp của agent, kết nối API tương thích OpenAI hoặc tạo prompt hoàn chỉnh rồi dùng quy trình trực tuyến được cung cấp.

Các skill hiện có

Kho mã gồm 12 skill độc lập. Bạn có thể cài đặt toàn bộ hoặc chỉ sao chép những thư mục cần dùng.

• amazon-white-background tạo ảnh chính Amazon với nền trắng tinh, không có văn bản và kiểm tra độ phủ sản phẩm.
• lifestyle-scene tạo các bối cảnh sử dụng sản phẩm như nhà bếp, ngoài trời, văn phòng và tập thể dục.
• model-try-on chuyển ảnh sản phẩm chụp phẳng hoặc trên móc treo thành ảnh người mẫu mặc thử, đồng thời giữ nguyên chất liệu, màu sắc và logo.
• selling-point-infographic tạo infographic mỗi ảnh tập trung vào một lợi ích, kèm biểu tượng, chú thích và nội dung đã xác nhận.
• amazon-a-plus tạo module Amazon A+ với nhiều kích thước được hỗ trợ và có kèm script cắt ảnh.
• size-chart tạo bảng kích thước và bảng thông số quần áo bằng centimet, inch và các con số do người dùng cung cấp.
• multi-angle-set tạo bộ ảnh nhất quán gồm góc trước, bên, sau, trên, 45 độ và cận cảnh.
• sale-banner tạo banner chiến dịch cho các sàn như Taobao, Tmall, Shopee, Lazada, TikTok Shop và Amazon.
• batch-background-swap xử lý nhiều ảnh hoặc các biến thể màu SKU với khả năng tiếp tục, thử lại, giới hạn ngân sách và ghi nhật ký CSV.
• xiaohongshu-cover tạo ảnh bìa Xiaohongshu tỷ lệ 3:4 với sáu kiểu bố cục.
• taobao-detail-long-image lập kế hoạch, ghép và chia các trang chi tiết Taobao, Tmall và Pinduoduo rộng 750 pixel.
• ecommerce-listing-suite đóng vai trò điều phối, lập kế hoạch cho bộ nội dung listing hoàn chỉnh của nền tảng và phối hợp 11 skill còn lại.

Cài đặt và thiết lập

Tùy chọn 1: Cài đặt bằng Skills CLI

Phương pháp cài đặt nhanh nhất là:

npx skills add xianyu110/ecommerce-image-skills

Bạn cũng có thể thêm kho mã dưới dạng plugin Claude Code:

/plugin marketplace add xianyu110/ecommerce-image-skills

Tùy chọn 2: Clone và sao chép các skill

Trước tiên, hãy clone kho mã:

git clone https://github.com/xianyu110/ecommerce-image-skills.git
cd ecommerce-image-skills

Để cài đặt Claude Code trên toàn hệ thống, hãy sao chép các thư mục skill vào thư mục Claude:

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

Đối với Codex, sử dụng:

mkdir -p ~/.codex/skills
cp -r skills/* ~/.codex/skills/

Đối với Cursor, hãy cài đặt các skill bên trong dự án hiện tại:

mkdir -p .cursor/skills
cp -r skills/* .cursor/skills/

Mỗi thư mục skill đều độc lập. Để chỉ cài đặt một skill, hãy sao chép riêng thư mục đó:

cp -r skills/amazon-white-background ~/.claude/skills/

Chọn phương thức tạo ảnh

Bạn có thể tạo ảnh theo ba cách:

1. Công cụ hình ảnh tích hợp của agent: nếu agent của bạn cung cấp công cụ tạo ảnh, skill có thể tự động sử dụng công cụ đó.
2. API tương thích OpenAI: thiết lập GPTIMAGE_API_KEY và tùy chọn GPTIMAGE_BASE_URL, sau đó sử dụng script Python tạo ảnh đi kèm.
3. Không có khóa hoặc công cụ hình ảnh: skill sẽ xuất prompt hoàn chỉnh và liên kết để chạy trực tuyến tại gptimage2.asia.

Để tạo ảnh qua API, hãy cấu hình thông tin xác thực trong shell:

export GPTIMAGE_API_KEY=sk-...
export GPTIMAGE_BASE_URL=https://tryallapi.com/v1

Điểm cuối API mặc định là https://api.openai.com, nhưng repository hỗ trợ mọi gateway tương thích thông qua GPTIMAGE_BASE_URL.

Cách sử dụng cơ bản

Tạo ảnh chính cho Amazon

Đặt ảnh sản phẩm vào một thư mục cục bộ và yêu cầu agent chạy skill phù hợp:

Use amazon-white-background on ./photos/bottle.jpg and run the check script.

Skill này được thiết kế cho nền trắng tinh, không có văn bản và sản phẩm chiếm ít nhất tỷ lệ diện tích yêu cầu trong ảnh. Sau khi tạo ảnh, skill có thể chạy kiểm tra bằng Python và tùy chọn sửa các điểm ảnh gần trắng.

Tạo bộ ảnh Amazon hoàn chỉnh

Sử dụng trình điều phối khi bạn cần nhiều hơn một tài sản:

Plan a full 7-image Amazon set for this bottle with ecommerce-listing-suite. Show me the plan first.

Yêu cầu lập kế hoạch trước cho phép bạn xem lại trình tự ảnh dự kiến trước khi tạo. Trình điều phối có thể phối hợp các skill riêng lẻ và thực hiện kiểm tra chất lượng hình ảnh.

Tạo ảnh phong cách sống và mạng xã hội

Để tạo cảnh sản phẩm, hãy sử dụng yêu cầu tập trung:

Use lifestyle-scene to create three outdoor lifestyle images for ./photos/bottle.jpg.

Đối với Xiaohongshu, hãy chỉ định tiêu đề mong muốn và yêu cầu nhiều biến thể:

Use xiaohongshu-cover to create three Xiaohongshu covers with the title "A water bottle that stays cold all day".

Chạy quá trình tạo ảnh qua API

Khi sử dụng endpoint tương thích với OpenAI, hãy gọi script tạo ảnh của skill. Ví dụ này sử dụng skill Amazon và model Sunburst:

python skills/amazon-white-background/scripts/generate.py \
  --model sunburst \
  --image bottle.jpg \
  --size 1024x1024 \
  --prompt-file prompt.txt \
  --out out/main.png

Các script và tham số chính xác được tích hợp trong thư mục skill tương ứng. Hãy đọc SKILL.md của skill đó để nắm quy trình và yêu cầu trước khi điều chỉnh lệnh.

Kiểm tra và sửa ảnh chính

Sau khi tạo ảnh chính cho Amazon, hãy chạy trình kiểm tra:

python skills/amazon-white-background/scripts/check_main_image.py \
  out/main.png \
  --fix out/main-fixed.png

Ví dụ trong README sử dụng script này để chuẩn hóa các điểm ảnh gần trắng thành #FFFFFF và xác minh các yêu cầu đối với ảnh chính.

Định tuyến model: Flare hay Sunburst?

Sử dụng Flare, được biểu diễn bằng gpt-image-2.5-flare, cho các cảnh mới, nền, bố cục, ảnh ý tưởng và các bộ biến thể tạo nhanh. Đây là model mặc định cho cảnh phong cách sống, module A+, banner khuyến mãi, ảnh bìa Xiaohongshu và trang chi tiết Taobao.

Sử dụng Sunburst, được biểu diễn bằng gpt-image-2.5-sunburst, khi việc bảo toàn logo, nhãn hoặc văn bản nhỏ là quan trọng. Đây cũng là lựa chọn được khuyến nghị cho các chỉnh sửa cục bộ như thay đổi nền, đổi màu hoặc xóa vật thể không mong muốn. Model này được các skill nền trắng, thử đồ, infographic, biểu đồ kích thước, đa góc và chỉnh sửa hàng loạt của repository sử dụng.

Mẹo nâng cao để đạt kết quả ổn định

Bắt đầu bằng việc kiểm tra nhận diện sản phẩm

Sử dụng ảnh nguồn rõ nét và đảm bảo hình dạng, màu sắc, logo, nhãn cũng như phần chữ hiển thị trên sản phẩm đều dễ kiểm tra. Quy trình khóa nhận diện là trọng tâm trong cách tiếp cận của repository, vì vậy thông tin nguồn chính xác sẽ cải thiện mọi ảnh ở các bước tiếp theo.

Tách giai đoạn khám phá khỏi sản xuất cuối

Sử dụng Flare để khám phá nhiều hướng cảnh hoặc bố cục, sau đó chuyển sang Sunburst cho các ảnh cuối cần giữ nguyên chi tiết sản phẩm, logo hoặc văn bản. Cách này giúp thử nghiệm ban đầu nhanh chóng, đồng thời dành quy trình cẩn trọng hơn cho các tài sản cuối.

Sử dụng script xác định sau khi tạo ảnh

Model hình ảnh hữu ích cho việc bố cục trực quan, nhưng script phù hợp hơn với các bước kiểm tra và biến đổi có thể lặp lại. Chạy trình kiểm tra nền trắng cho ảnh Amazon, sử dụng công cụ cắt cho module A+ và dùng script ghép hoặc chia ảnh cho các trang chi tiết dài.

Đặt giới hạn cho xử lý hàng loạt

Với các thư mục lớn, hãy sử dụng batch-background-swap cùng ngân sách số lần gọi tối đa. Skill hỗ trợ thử lại, tiếp tục từ trạng thái trước đó và ghi log CSV, giúp bạn khôi phục sau khi bị gián đoạn mà không phải khởi động lại toàn bộ lô.

Batch-replace backgrounds in ./photos with pure white, cap at 40 API calls.

Xem lại quy định nền tảng trước khi tải lên

Repository bao gồm kích thước và quy tắc trình bày theo từng nền tảng, nhưng yêu cầu của các sàn có thể thay đổi. Luôn xác minh hướng dẫn hiện hành dành cho người bán trước khi đăng ảnh, đặc biệt đối với Amazon, Taobao, Tmall, Shopee, TikTok Shop và Xiaohongshu.

Quy trình mẫu: Từ một ảnh đến bộ ảnh sản phẩm

1. Đặt ảnh sản phẩm gốc vào ./photos và kiểm tra các chi tiết sản phẩm hiển thị.
2. Yêu cầu ecommerce-listing-suite lập kế hoạch cho sàn thương mại điện tử mục tiêu.
3. Tạo ảnh chính nền trắng cho Amazon bằng amazon-white-background.
4. Chạy trình kiểm tra ảnh chính và áp dụng tùy chọn sửa lỗi nếu cần.
5. Tạo các cảnh phong cách sống bổ trợ bằng lifestyle-scene và đồ họa nêu bật tính năng bằng selling-point-infographic.
6. Thêm bảng kích thước, ảnh chụp nhiều góc hoặc mô-đun A+ khi sản phẩm yêu cầu.
7. Tạo nội dung cho mạng xã hội hoặc chiến dịch bằng xiaohongshu-cover và sale-banner.
8. Kiểm tra từng ảnh theo các yêu cầu hiện hành của sàn trước khi tải lên.

Kết luận

Ecommerce Image Skills cung cấp một quy trình thực tế, có thể tái sử dụng để tạo ảnh cho sàn thương mại điện tử và thương mại xã hội từ những ảnh sản phẩm thông thường. Cài đặt các skill trong coding agent bạn предпочор thích, chọn skill dành riêng cho nền tảng, chọn Flare hoặc Sunburst tùy theo tác vụ và sử dụng các script đi kèm để kiểm tra nhất quán cũng như xử lý hàng loạt. Với các chiến dịch hoàn chỉnh, hãy để ecommerce-listing-suite lập kế hoạch và điều phối toàn bộ bộ ảnh.

Dự án được phát hành theo Giấy phép MIT. Vì chính sách của các sàn có thể thay đổi, hãy xem các thông số kỹ thuật tích hợp sẵn là nền tảng quy trình và xác nhận các yêu cầu mới nhất trước khi xuất bản.