Seedream 4.0 Image API | PixMind Docs

Flexible 1K, 2K, and 4K image generation and editing.

Provider

ByteDance

Model ID

seedream-4.0

Endpoint

POST /api-platform/v1/generations

Open model playground Create API key

Model notes

Prices below mirror the backend apiPlatform pricing tree audited on 2026-08-10.

Request parameters

Parameter	Type	Required	Description
`model`	string	Yes	Stable PixMind model ID. Use `seedream-4.0`. Allowed values: `seedream-4.0`
`prompt`	string	Yes	Natural-language generation or editing instructions.
`resolution`	string	No	Output resolution tier. This field affects request pricing. Allowed values: `1K`, `2K`, `4K` Default: `1K`
`aspectRatio`	string	No	Requested output aspect ratio. Allowed values: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:6`, `6:5`, `2:1` Default: `1:1`
`referenceImages`	string[] (URI)	No	Reference image URLs used for editing, composition, subject, or style guidance.
`n`	integer	No	Number of images to generate in this request. Allowed values: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10` Default: `1`

Request example

cURL

curl https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-4.0",
  "prompt": "Create a polished campaign image while preserving the supplied subject",
  "resolution": "1K",
  "aspectRatio": "1:1",
  "referenceImages": [
    "https://example.com/reference.png"
  ]
}'

JavaScript

const response = await fetch("https://aihub-admin.aimix.pro/api-platform/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "seedream-4.0",
  "prompt": "Create a polished campaign image while preserving the supplied subject",
  "resolution": "1K",
  "aspectRatio": "1:1",
  "referenceImages": [
    "https://example.com/reference.png"
  ]
})
});

const task = await response.json();

Accepted task response

Generation is asynchronous. Save taskId and poll GET /api-platform/v1/tasks/{taskId} until status is ready or failed.

200 OK

{
  "code": 1000,
  "data": {
    "id": "img_44160",
    "taskId": 44160,
    "type": "image",
    "model": "seedream-4.0",
    "status": "processing"
  }
}

API pricing

Configuration	Price
1K output	$0.040 / image
2K output	$0.060 / image
4K output	$0.070 / image

API pricing uses the apiPlatform role and is separate from PixMind Studio credits. The accepted task response is the final pricing snapshot.