Seedream

Seedream モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 11 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST

POST https://api.lithovas.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET

GET https://api.lithovas.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期

タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデル	タスク	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

POSTText to Imageseedream/seedream

input フィールド

promptstring必須

Text prompt for image generation (max 5000 characters)

image_sizeenum<string>任意

Output image dimensions and aspect ratio

guidance_scalenumber任意

Controls prompt alignment strength; range 1-10 (step 0.1)

seedinteger任意

Random seed for controlling generation stochasticity

例

cURL

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

POSTText to Imageseedream/seedream-v4-text-to-image

input フィールド

promptstring必須

Text prompt for image generation (max 5000 characters)

image_sizeenum<string>任意

Aspect ratio of generated image

image_resolutionenum<string>任意

Pixel scale determining final resolution

max_imagesnumber任意

Number of images to generate per run (1-6)

seedinteger任意

Random seed for controlling generation stochasticity

nsfw_checkerboolean任意

Enable/disable content filtering on results

例

cURL

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

POSTImage Editingseedream/seedream-v4-edit

input フィールド

promptstring必須

Text prompt for image editing (max 5000 characters)

image_urlsarray<string>必須

URLs of input images for editing (up to 10 images, max 10MB each)

image_sizeenum<string>任意

Aspect ratio of generated image

image_resolutionenum<string>任意

Pixel scale determining final resolution

max_imagesnumber任意

Number of images to generate per run (1-6)

seedinteger任意

Random seed for controlling generation stochasticity

nsfw_checkerboolean任意

Enable/disable content filtering on results

例

cURL

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

POSTText to Imageseedream/4-5-text-to-image

input フィールド

promptstring必須

Text description of the image to generate (max 3000 characters)

aspect_ratioenum<string>必須

Width-height ratio determining the image's visual form

qualityenum<string>必須

Output resolution: basic (2K) or high (4K)

nsfw_checkerboolean任意

Content filtering toggle; false disables filtering

例

cURL

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

POSTImage Editingseedream/4-5-edit

input フィールド

promptstring必須

Text description of the image to generate (max 3000 chars)

image_urlsarray<string>必須

Input image files for the API (max 14 images, 10MB each)

aspect_ratioenum<string>必須

Width-height ratio of the image, determining its visual form

qualityenum<string>必須

Basic outputs 2K images, High outputs 4K images

nsfw_checkerboolean任意

Toggle content filtering; disabled when false

例

cURL

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

POSTText to Imageseedream/5-lite-text-to-image

input フィールド

promptstring必須

Text description of the image to generate (3-3000 characters)

aspect_ratioenum<string>必須

Width-height ratio of the image, determining its visual form

qualityenum<string>必須

Basic outputs 2K images; High outputs 4K images

output_formatenum<string>任意

Format of the output image

nsfw_checkerboolean任意

Disable content filtering when false

例

cURL

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

POSTImage to Imageseedream/5-lite-image-to-image

input フィールド

promptstring必須

Text prompt describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例

cURL

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

POSTText to Imageseedream/5-pro-text-to-image

input フィールド

promptstring必須

Text description of the image to generate (3-5000 characters)

aspect_ratiostring必須

Width-height ratio of the image, determining its visual form

qualitystring必須

Basic outputs 1K images, while High outputs 2K images

output_formatstring任意

Format of the output image

nsfw_checkerboolean任意

Content filtering toggle; when false, filtering is disabled

例

cURL

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

POSTImage to Imageseedream/5-pro-image-to-image

input フィールド

promptstring必須

Text description of image to generate (3-5000 characters)

image_urlsarray<string>必須

Input image file URLs (JPEG/PNG/WebP, max 10MB each, up to 10 images)

aspect_ratiostring必須

Width-height ratio determining visual form

qualitystring必須

Output resolution: basic (1K) or high (2K)

output_formatstring任意

Format of output image

nsfw_checkerboolean任意

Enable content filtering; false disables filtering

例

cURL

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

POSTImage Editingseedream/5-pro-layer-decomposition

input フィールド

promptstring必須

Instructions describing which visual elements to separate into independent layers. Supports bbox references such as <bbox>179 58 809 197</bbox>.

image_urlstring必須

Source image URL to decompose into editable layers.

sizeenum<string>任意

Output resolution tier.

output_formatenum<string>任意

Generated layer image format.

例

cURL

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

POSTText to Imageseedream/seedream-v3

input フィールド

promptstring必須

Text prompt describing the desired output.

aspect_ratiostring任意

Output aspect ratio, e.g. "1:1", "16:9".

例

cURL

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"
  }
}'