✨ Node.js Version: This script is implemented with Node.js, no Python environment required. The entry script automatically detects the Node.js runtime (prioritizes system node, falls back to LobsterAI's built-in runtime), allowing Windows and Mac users to use it out of the box.

• Base URL:

  https://ark.cn-beijing.volces.com/api/v3

• API Key: Read from environment variable

  ARK_API_KEY

• Authentication:

  Authorization: Bearer {API_KEY}

• SDK: Compatible with Volcengine Ark Python SDK

1. Submit Request - Call the API to submit an image generation request
2. Wait for Generation - The API directly processes and generates the image (usually 30-60 seconds)
3. Download Image - Download the generated image file from the returned URL

• IPM (Images Per Minute): 500 images/minute (Seedream 4.5, 4.0)
• Rate limits vary by model. Please refer to the official documentation.

• Task data (including image URLs) is only retained for 24 hours
• It will be automatically cleared after the timeout
• Be sure to download and save the generated images in a timely manner

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "Dynamic close-up editorial portrait with a model having sharp eyes, wearing a sculptural hat, rich color blocking, shallow depth of field, Vogue magazine cover aesthetic" \
  --output portrait.png

• "Realistic style, under a clear blue sky, a large field of white daisies, the camera gradually zooms in, finally focusing on a close-up of a single daisy"
• "Cartoon style, an orange kitten sitting on a windowsill, sunlight shining on it, warm and healing atmosphere"
• "Cyberpunk style, future city night scene, neon lights flickering, tall buildings lining the streets"

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "Change the clothing in image 1 to the clothing in image 2" \
  --image "/Users/yourname/Pictures/person.jpg" \
  --image "https://example.com/clothes.jpg" \
  --output fusion_result.png

• Virtual try-on: Person image + clothing image → Outfit preview
• Style transfer: Photo + style reference image → Styled work
• Scene fusion: Person + background → Composite scene

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "Search for the recently popular image of a white duck holding a windmill with one hand, design it into a giant installation from a highly impactful perspective" \
  --search \
  --output search_result.png

• Web search functionality is only available for the Seedream 5.0 lite model
• Using the

  --search

  parameter will automatically switch to the 5.0 lite model
• Suitable for creation scenarios that require integrating real-time information

• Model ID:

  doubao-seedream-4-5-251128

• Features: Latest version, best overall quality
• Supported Functions: Text-to-image, image-to-image, multi-image fusion, sequential image generation
• Output: 1K-4K resolution optional
• Rate Limit: IPM 500

• Model ID:

  doubao-seedream-4-0-250828

• Features: Mature and stable version
• Supported Functions: Text-to-image, image-to-image, multi-image fusion, sequential image generation
• Output: 1K-4K resolution optional
• Rate Limit: IPM 500

• Model ID:

  doubao-seedream-5-0-260128

• Features: Supports web search, integrates real-time online information
• Usage: Automatically enabled via the

  --search

  parameter
• Note: API will be officially available after 18:00 on February 24, 2026

• Pursue highest quality → 4.5
• Stable production environment → 4.0
• Need real-time information → 5.0 lite (use

  --search

  )

• Cause: API Key not configured
• Solution: Follow the instructions in the "How to Configure API Key" section

• Cause: Invalid or expired API Key
• Solution: Check if the API Key is correct, or regenerate it in the console

• Cause: Parameter error (e.g., unsupported size, empty prompt, etc.)
• Solution: Check if parameters meet requirements

• Cause: Generation time too long or API busy
• Solution: Increase the

  --timeout

  value, or try again later

• Cause: Violent content, unclear prompt, incorrect image format, etc.
• Solution: Check prompt content, ensure image URL is accessible

• Cause: Exceeded IPM limit
• Solution: Wait 1 minute and try again, or upgrade quota

• Cause: Incorrect local image path
• Solution: Check if the file path is correct, use absolute path

• Format: PNG, JPEG (automatically detected based on output parameter)
• Resolution: 1K / 2K / 4K (based on size parameter)
• File Size: Approximately 0.5-10 MB (depends on resolution and complexity)
• Naming Rules:
  • Single image: Specified file name
  • Sequential images:

    filename_1.png

    ,

    filename_2.png

    , ...

1. Clear Subject Description - Explain the main content of the image
2. Specific Style Specification - Realistic, cartoon, cyberpunk, etc.
3. Detail Supplements - Colors, lighting, atmosphere, etc.
4. Composition Instructions - Close-up, panoramic, bird's-eye view, etc.

• ✅ Specific description: "Kitten chasing a butterfly" instead of "Kitten playing"
• ✅ Style explanation: "Cyberpunk style" instead of "Nice-looking"
• ✅ Rich details: "Orange long-haired kitten with blue eyes" instead of "Cat"
• ❌ Avoid ambiguity: Too abstract descriptions increase randomness
• ❌ Avoid excessive length: Best to keep within 200 words
• ❌ Avoid violations: Do not include violent, pornographic, or other prohibited content

• API Reference: https://www.volcengine.com/docs/82379/1541523
• Console: https://console.volcengine.com/ark
• API Key Management: https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
• Model List: https://www.volcengine.com/docs/82379/1330310

1. Check the error messages output by the script
2. Verify that the API Key configuration is correct
3. Visit the Volcengine Ark Console to view task details
4. Refer to the official website documentation for more details