Seedream
Seedream-Modelle werden über eine einheitliche, asynchrone Job-API aufgerufen. Starte einen Task mit POST /api/generate und frage dann GET /api/generate/{taskId} ab, bis er fertig ist. Diese Familie stellt 11 Endpunkte bereit.
Überblick
Jeder Endpunkt teilt sich dieselbe Hülle — nur model und die input-Felder ändern sich. Führe einen beliebigen im Playground des Modell-Markts aus.
Authentifizierung
Erstelle einen API-Schlüssel unter /api-keys und sende ihn als Bearer-Token. Anfragen aus dem Browser bei angemeldeter Sitzung funktionieren auch über das Session-Cookie.
Authorization: Bearer <YOUR_API_KEY>Task erstellen
POST https://api.lithovas.com/api/generateBody: { "model": "<slug>", "input": { … } }
Antwort: { "taskId": "<id>", "state": "waiting" }
Ergebnis abfragen
GET https://api.lithovas.com/api/generate/<taskId>Antwort: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }
state zu success oder fail wird. Fehlgeschlagene Tasks werden nicht berechnet.Endpunkte
| Modell | Task | model slug |
|---|---|---|
| Seedream | Text to Image | seedream/seedream |
| Seedream V4 | Text to Image | seedream/seedream-v4-text-to-image |
| Seedream V4 Edit | Image Editing | seedream/seedream-v4-edit |
| Seedream 4.5 | Text to Image | seedream/4-5-text-to-image |
| Seedream 4.5 Edit | Image Editing | seedream/4-5-edit |
| Seedream 5 Lite | Text to Image | seedream/5-lite-text-to-image |
| Seedream 5 Lite | Image to Image | seedream/5-lite-image-to-image |
| Seedream 5 Pro | Text to Image | seedream/5-pro-text-to-image |
| Seedream 5 Pro | Image to Image | seedream/5-pro-image-to-image |
| Seedream 5 Pro Layer Decomposition | Image Editing | seedream/5-pro-layer-decomposition |
| Seedream V3 | Text to Image | seedream/seedream-v3 |
Seedream · Text to Image
seedream/seedreampromptstringerforderlichText prompt for image generation (max 5000 characters)
image_sizeenum<string>optionalOutput image dimensions and aspect ratio
guidance_scalenumberoptionalControls prompt alignment strength; range 1-10 (step 0.1)
seedintegeroptionalRandom seed for controlling generation stochasticity
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/seedream",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_size": "square_hd",
"guidance_scale": 2.5,
"seed": 42
}
}'Seedream V4 · Text to Image
seedream/seedream-v4-text-to-imagepromptstringerforderlichText prompt for image generation (max 5000 characters)
image_sizeenum<string>optionalAspect ratio of generated image
image_resolutionenum<string>optionalPixel scale determining final resolution
max_imagesnumberoptionalNumber of images to generate per run (1-6)
seedintegeroptionalRandom seed for controlling generation stochasticity
nsfw_checkerbooleanoptionalEnable/disable content filtering on results
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/seedream-v4-text-to-image",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_size": "square_hd",
"image_resolution": "1K",
"max_images": 1,
"seed": 42,
"nsfw_checker": false
}
}'Seedream V4 Edit · Image Editing
seedream/seedream-v4-editpromptstringerforderlichText prompt for image editing (max 5000 characters)
image_urlsarray<string>erforderlichURLs of input images for editing (up to 10 images, max 10MB each)
image_sizeenum<string>optionalAspect ratio of generated image
image_resolutionenum<string>optionalPixel scale determining final resolution
max_imagesnumberoptionalNumber of images to generate per run (1-6)
seedintegeroptionalRandom seed for controlling generation stochasticity
nsfw_checkerbooleanoptionalEnable/disable content filtering on results
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/seedream-v4-edit",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_urls": [
"https://example.com/input.jpg"
],
"image_size": "square_hd",
"image_resolution": "1K",
"max_images": 1,
"seed": 42,
"nsfw_checker": false
}
}'Seedream 4.5 · Text to Image
seedream/4-5-text-to-imagepromptstringerforderlichText description of the image to generate (max 3000 characters)
aspect_ratioenum<string>erforderlichWidth-height ratio determining the image's visual form
qualityenum<string>erforderlichOutput resolution: basic (2K) or high (4K)
nsfw_checkerbooleanoptionalContent filtering toggle; false disables filtering
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/4-5-text-to-image",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"aspect_ratio": "1:1",
"quality": "basic",
"nsfw_checker": false
}
}'Seedream 4.5 Edit · Image Editing
seedream/4-5-editpromptstringerforderlichText description of the image to generate (max 3000 chars)
image_urlsarray<string>erforderlichInput image files for the API (max 14 images, 10MB each)
aspect_ratioenum<string>erforderlichWidth-height ratio of the image, determining its visual form
qualityenum<string>erforderlichBasic outputs 2K images, High outputs 4K images
nsfw_checkerbooleanoptionalToggle content filtering; disabled when false
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/4-5-edit",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_urls": [
"https://example.com/input.jpg"
],
"aspect_ratio": "1:1",
"quality": "basic",
"nsfw_checker": false
}
}'Seedream 5 Lite · Text to Image
seedream/5-lite-text-to-imagepromptstringerforderlichText description of the image to generate (3-3000 characters)
aspect_ratioenum<string>erforderlichWidth-height ratio of the image, determining its visual form
qualityenum<string>erforderlichBasic outputs 2K images; High outputs 4K images
output_formatenum<string>optionalFormat of the output image
nsfw_checkerbooleanoptionalDisable content filtering when false
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/5-lite-text-to-image",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"aspect_ratio": "1:1",
"quality": "basic",
"output_format": "png",
"nsfw_checker": false
}
}'Seedream 5 Lite · Image to Image
seedream/5-lite-image-to-imagepromptstringerforderlichText prompt describing the desired output.
image_urlsstring[]erforderlichOne or more source image URLs to condition on.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/5-lite-image-to-image",
"input": {
"prompt": "a red panda",
"image_urls": [
"https://example.com/in.jpg"
]
}
}'Seedream 5 Pro · Text to Image
seedream/5-pro-text-to-imagepromptstringerforderlichText description of the image to generate (3-5000 characters)
aspect_ratiostringerforderlichWidth-height ratio of the image, determining its visual form
qualitystringerforderlichBasic outputs 1K images, while High outputs 2K images
output_formatstringoptionalFormat of the output image
nsfw_checkerbooleanoptionalContent filtering toggle; when false, filtering is disabled
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/5-pro-text-to-image",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"aspect_ratio": "1:1",
"quality": "basic",
"output_format": "png",
"nsfw_checker": false
}
}'Seedream 5 Pro · Image to Image
seedream/5-pro-image-to-imagepromptstringerforderlichText description of image to generate (3-5000 characters)
image_urlsarray<string>erforderlichInput image file URLs (JPEG/PNG/WebP, max 10MB each, up to 10 images)
aspect_ratiostringerforderlichWidth-height ratio determining visual form
qualitystringerforderlichOutput resolution: basic (1K) or high (2K)
output_formatstringoptionalFormat of output image
nsfw_checkerbooleanoptionalEnable content filtering; false disables filtering
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/5-pro-image-to-image",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_urls": [
"https://example.com/input.jpg"
],
"aspect_ratio": "1:1",
"quality": "basic",
"output_format": "png",
"nsfw_checker": false
}
}'Seedream 5 Pro Layer Decomposition · Image Editing
seedream/5-pro-layer-decompositionpromptstringerforderlichInstructions describing which visual elements to separate into independent layers. Supports bbox references such as <bbox>179 58 809 197</bbox>.
image_urlstringerforderlichSource image URL to decompose into editable layers.
sizeenum<string>optionalOutput resolution tier.
output_formatenum<string>optionalGenerated layer image format.
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/5-pro-layer-decomposition",
"input": {
"prompt": "A cinematic red panda surfing through neon rain at dusk.",
"image_url": "https://example.com/input.jpg",
"size": "auto",
"output_format": "jpeg"
}
}'Seedream V3 · Text to Image
seedream/seedream-v3promptstringerforderlichText prompt describing the desired output.
aspect_ratiostringoptionalOutput aspect ratio, e.g. "1:1", "16:9".
curl -X POST https://api.lithovas.com/api/generate \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream/seedream-v3",
"input": {
"prompt": "a red panda",
"aspect_ratio": "1:1"
}
}'