Bytedance Seedream V5.0 Lite API Documentation

Bytedance Seedream V5.0 Lite API Documentation

Playground

Seedream 5.0 Lite by is a state-of-the-art text-to-image model with enhanced typography, clear text rendering for posters and brand visuals, superior prompt adherence, and up to 4K resolution. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Seedream V5.0 Lite is lightweight text-to-image model, generating high-quality images from text descriptions with fast inference speed. With flexible aspect ratios and custom resolution support up to 4K, it delivers stunning visuals at an affordable price.

Why Choose This?

• Lightweight & fast Optimized for speed while maintaining high visual quality.

• Flexible aspect ratios Multiple presets including 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, and 2:3.

• High resolution support Custom width and height from 1440 to 8192 pixels.

• Prompt Enhancer Built-in tool to automatically improve your descriptions for better results.

• Affordable pricing Just $0.035 per image for professional-quality output.

Parameters

How to Use

1. Write your prompt — describe the image in detail, including style, lighting, and composition.
2. Choose aspect ratio — select a preset or customize width/height.
3. Use Prompt Enhancer (optional) — click to automatically refine your description.
4. Run — submit and download your generated image.

Pricing

Best Use Cases

• Social Media Content — Create eye-catching visuals for Instagram, TikTok, and more.
• Photography Style — Generate photorealistic images with camera and lighting references.
• Marketing & Ads — Produce professional images for campaigns and promotions.
• Concept Art — Visualize ideas and creative concepts quickly.
• Personal Projects — Bring your creative visions to life affordably.

Pro Tips

• Be specific in your prompts — include camera settings, lighting, and style references for best results.
• Use cinematic language like “shot on Leica, golden hour, urban backdrop” for photorealistic output.
• Try the Prompt Enhancer to automatically improve your descriptions.
• Match aspect ratio to your target platform: 9:16 for Stories/Reels, 16:9 for banners, 1:1 for feeds.
• Lite version is great for quick iterations and high-volume generation.

Notes

• Prompt is the only required field.
• Resolution range: 1440–8192 pixels for both width and height.
• Ensure your prompts comply with content guidelines.

Related Models

• Seedream V5.0 Lite Edit — Edit images with text instructions.
• Seedream V4 Text-to-Image — Previous generation model.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "size": "2048*2048",
  "output_format": "jpeg"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.0-lite" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters