PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Seedream
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
        • Kontext
      • Get task
    • Gemini
      • Gemini-2.5-flash-image
      • Nano Banana Pro
      • Nano Banana 2
      • Get task
    • Qwen Image
      • Text to Image
      • Image Edit
      • Get task
    • Z-Image
      • Text to Image
      • Get task
    • Seedream
      • Seedream 5 Lite
        POST
      • Get Task
        GET
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
      • Create Task
      • Kling Virtual Try-On
      • Kling Effects
      • Kling Sound
      • Kling Avatar
      • Kling Motion Control
      • Kling Turbo
      • Kling 3.0
    • Kling omni
      • Kling o1
      • Kling 3.0 omni
      • Get Task
    • Omni Human
      • OmniHuman 1.5
      • Get task
    • Seedance
      • Less-Restriction Models Guide
      • Private Asset Library
      • Seedance 2
      • Video Watermark Remover
      • Get task
    • Veo3
      • Veo3 Text to Video
      • Veo3 Image to Video
      • Veo3.1 Text to Video
      • Veo3.1 Image to Video
      • Get task
    • Sora2
      • Sora2-preview Text to Video
      • Sora2 Text to Video
      • Sora2-Pro Text to Video
      • Sora2 Remove Watermark
      • Get task
    • WanX
      • Generate WanX Task with LoRA Using PiAPI
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Wan
      • Wan2.6 Text to Video
      • Wan2.6 Image to Video
      • Get task
    • Hailuo
      • Generate Video
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Available Hunyuan Lora models
      • Get Task
      • Generate Video
    • Luma Dream Machine
      • Create Task
      • Get Task
    • LLM
      • How To Avoid Timeouts in Completion API
      • LLM API | Basic Completions
    • Suno(service stopped)
      • Music(service stopped)
      • Lyrics(service stopped)
      • Get task
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Ace Step
      • Create Task
        • Text to Audio
        • Audio to Audio
        • Audio Edit
        • Audio Extend
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Trellis Create Task
      • Trellis2 Create Task
      • Get Task
    • Joycaption
      • Image Caption
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • AI Hug
      • Get Task
      • Create Task
    • Tools
      • File Upload API
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
      • Video Upscale
      • Video Upscale-Get Task
      • Video Remove Background
      • Video Remove Background-Get task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
    • GPT image
      • GPT-image API
    • Claude Code
      • Claude Code Usage Guide
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
      • The discontinued support for midjourney
      • Sunsetting Suno
  • Schemas
    • Schemas
      • motion brush
      • Create Task
      • camera control
      • Cancel Params
      • Float2 Point
      • Control Points
      • txt2video-1.3b
      • txt2video-14b
      • txt2video-14b-lora
      • img2video-14b
      • img2video-14b-lora
      • img2video-14b-keyframe
      • img2video-14b-control-camera
      • wan22-txt2video-14b
      • wan22-img2video-14b
      • hunyuan-txt2video-lora
      • Trellis API/text-to-3D
      • Trellis API/image-to-3D
      • Trellis2 API/image-to-3D
      • Kling omni multi shot
      • VideoGenerationRequest
      • TaskRequest
      • VideoGenerationResponse
      • TaskConfig
      • TaskInput
      • TaskResponse
      • ErrorResponse
    • Response
      • Unified-Task-Response
    • RequestBodies
      • Unified-Task-Request-Body
    • config
    • control_net_setting
    • lora_setting
  1. Seedream

Seedream 5 Lite

POST
https://api.piapi.ai/api/v1/task

Overview#

Seedream 5.0 Lite provides high-quality image generation from text prompts, with optional image references for editing. It supports 2K and 3K output resolutions and is delivered synchronously (no polling required).

Currently available models#

ModelContent moderation
seedream-5-liteStrict
seedream-5-lite-less-restrictionLess restrictive
The -less-restriction variant applies a more permissive content review. It accepts exactly the same input schema as the strict model but bills at a +25% markup. See Content Moderation below.

Pricing#

ModelSizePrice per image
seedream-5-lite2K (default)$0.028
seedream-5-lite3K$0.042
seedream-5-lite-less-restriction2K (default)$0.035
seedream-5-lite-less-restriction3K$0.0525
3K is priced at 1.5× the 2K rate within the same tier.
The -less-restriction variant is priced at a +25% markup over the strict variant at the same size.

Parameters#

size#

Controls output resolution. Accepted values: 2K (default) or 3K.

aspect_ratio#

Supported ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9. Default: 1:1.
The upstream API does not accept an aspect_ratio field directly; this engine encodes the requested ratio into the pixel dimensions sent upstream.

output_format#

Output image format. Accepted values: jpeg (default), png, webp.

image_urls#

Optional. Provide up to 10 image URLs to use as references for editing / style transfer. Use publicly accessible URLs (CDN or cloud storage); signed/expiring URLs may fail.

sequential_image_generation (advanced)#

disabled (default) or auto. When auto, supply max_images (1–15) to control batch size; the model will return multiple related images in a single request.

Content moderation#

Both models apply content moderation. Submissions found to contain disallowed content are rejected and your credits are refunded.
seedream-5-lite (strict) applies our standard content review.
seedream-5-lite-less-restriction applies a more permissive content review. A rejection is final and is not retried — your credits are refunded and the task ends with a content-violation error.

Response#

Seedream is delivered synchronously. The response contains the generated image URLs directly — no polling is required.

Tips#

Use publicly accessible URLs for any reference images.
For 3K output, expect slightly longer generation times than 2K.
The output is one or more images (not video).

Request

Header Params

Body Params application/json

Examples
{
    "model": "seedream",
    "task_type": "seedream-5-lite",
    "input": {
        "prompt": "A golden retriever playing in a field of sunflowers at sunset",
        "aspect_ratio": "16:9",
        "output_format": "png",
        "size": "2K"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.piapi.ai/api/v1/task' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "model": "seedream",
    "task_type": "seedream-5-lite",
    "input": {
        "prompt": "A golden retriever playing in a field of sunflowers at sunset",
        "aspect_ratio": "16:9",
        "output_format": "png",
        "size": "2K"
    }
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "data": {
        "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "model": "seedream",
        "task_type": "seedream-5-lite",
        "status": "pending",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "",
                "secret": ""
            }
        },
        "input": {
            "prompt": "A golden retriever playing in a field of sunflowers at sunset",
            "aspect_ratio": "16:9",
            "output_format": "png",
            "size": "2K"
        },
        "output": null,
        "meta": {
            "created_at": "2026-03-16T10:00:00.000000000Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 280000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}
Modified at 2026-06-01 10:39:49
Previous
Get task
Next
Get Task