Skip to main content
POST
/
generation
/
bytedance
/
seedream-4.0
Seedream 4.0
curl --request POST \
  --url https://open.ppt.video/api/v1/generation/bytedance/seedream-4.0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>"
}
'
{
  "id": "<string>",
  "status": "starting",
  "usage": {
    "total": 0,
    "subscription": 0,
    "permanent": 0
  }
}
Seedream 4.0 video generation model

Authorizations

​
Authorization
string
header
required

API Key for API endpoints

Body

application/json
​
prompt
string
required

Text prompt for image generation

​
n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4
​
size
enum<string>
default:2K

Image resolution: 1K (1024px), 2K (2048px), 4K (4096px), or 'custom' for specific dimensions.

Available options:
1K,
2K,
4K,
custom
​
width
integer
default:2048

Custom image width (only used when size='custom'). Range: 1024-4096 pixels.

Required range: 1024 <= x <= 4096
​
height
integer
default:2048

Custom image height (only used when size='custom'). Range: 1024-4096 pixels.

Required range: 1024 <= x <= 4096
​
max_images
integer
default:1

Maximum number of images to generate when sequential_image_generation='auto'. Range: 1-15. Total images (input + generated) cannot exceed 15.

Required range: 1 <= x <= 15
​
image_input
string<uri>[]

Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation.

​
aspect_ratio
enum<string>
default:match_input_image

Image aspect ratio. Only used when size is not 'custom'. Use 'match_input_image' to automatically match the input image's aspect ratio.

Available options:
match_input_image,
1:1,
4:3,
3:4,
16:9,
9:16,
3:2,
2:3,
21:9
​
enhance_prompt
boolean
default:true

Enable prompt enhancement for higher quality results, this will take longer to generate.

​
sequential_image_generation
enum<string>
default:disabled

Group image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations).

Available options:
disabled,
auto

Response

Generation status

​
id
string
required

Generation id.

​
status
enum<string>
required

Generation status

Available options:
starting,
processing,
succeeded,
failed,
canceled
​
usage
object
required

Credit usage breakdown for the request