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.