seedream-imagegen

Generate images from text prompts via the ByteDance Seedream 4.0 API on Segmind.

706|130|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/staruhub/ClaudeSkills --skill seedream-imagegen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seedream-imagegen
Source: https://github.com/staruhub/ClaudeSkills/tree/main/lab/Geek-skills-seedream-imagegen
Command: npx skills add https://github.com/staruhub/ClaudeSkills --skill seedream-imagegen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Turning a rough idea into a usable marketing image, poster, product shot, or concept visual normally requires design tools or a designer. This Skill converts text descriptions into high-quality images through the Seedream 4.0 API, handling prompt optimization, size and aspect-ratio selection, and batch generation so the output matches the intended use case.

Core Features & Use Cases

  • Structured prompt optimization: Rewrites short user input into a [subject] + [style] + [details] + [quality] prompt before calling the API, instead of passing raw text through.
  • Use-case parameter mapping: Maps purposes like social media, web banners, print posters, and product shots to appropriate size (2K/4K/custom), aspect ratio, and image count settings.
  • Batch and reference-guided generation: Supports up to 15 images per request, up to 3 reference images for style guidance, and sequential generation for consistent series.
  • Use Case: Ask for a set of tech-style concept images in dark blue tones, and receive 5 optimized 2K 16:9 images saved to disk with their file paths reported back.

Quick Start

Use seedream-imagegen to generate a 2K 16:9 business-style product poster from my description.

Frequently Asked Questions about seedream-imagegen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images with the Seedream 4.0 API?

Run the generate_image.py script with a prompt, size, and aspect ratio, authenticating via the SEGMIND_API_KEY environment variable or the --api-key flag. The script posts to the Segmind seedream-4 endpoint and saves the resulting images to a local output directory.

What image sizes and aspect ratios does Seedream 4.0 support?

Seedream 4.0 supports 2K (2048x2048), 4K (4096x4096), and custom dimensions between 1024 and 4096 pixels. Aspect ratios include 1:1, 16:9, 9:16, 4:3, 3:2, 3:4, 2:3, and 21:9.

Can I use reference images to control the generated style?

Yes, the image_input parameter accepts up to 3 reference image URLs per request to guide style, brand consistency, or composition. Reference images only steer generation; the API does not edit the reference images themselves.

Why does the Seedream API return a 401 or quota error?

A 401 or quota error means the SEGMIND_API_KEY is missing, invalid, or out of credits. Verify the key from your segmind.com account and check the x-remaining-credits response header; the skill reports the issue rather than silently retrying.

What are the limitations of Seedream text-to-image generation?

It only performs text-to-image generation, not editing or extending existing images, and not video. Each request is capped at 15 images and 3 reference images, and 4K generation takes roughly 4-6 seconds per image versus about 2 seconds for 2K.