Image Generation

Seedream 5.5 API

Seedream 5.5: the newest Seedream image model. Sharp, realistic images in seconds, exact text, edits that keep the subject the same, and transparent backgrounds. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Img2Img

Editing

Credit Cost

1 credit

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/seedream-5-5/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/seedream-5-5.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text description of the image to generate	-
`image_size`	enum	Output size preset or resolution. From a text prompt: 0.5 credits per image at 1K (auto_1K), 1 at 2K. With reference images: 1 at 1K, 1.5 at 2K. auto_1K and auto_2K keep a reference image's shape and are square from a text prompt, so for a set aspect ratio use a landscape_/portrait_ preset, or custom with customWidth and customHeight (e.g. 2048x1152 for 16:9). `auto_1Kauto_2Ksquare_1_1landscape_16_9portrait_9_16`+5 more	`auto_2K`
`customWidth`	integer	Custom width in pixels. Snapped to a multiple of 16; total pixels must be between 921,600 (1280×720) and 4,194,304 (2048×2048). min: 256 \| max: 4096	-
`customHeight`	integer	Custom height in pixels. Snapped to a multiple of 16; total pixels must be between 921,600 (1280×720) and 4,194,304 (2048×2048). min: 256 \| max: 4096	-
`seed`	integer	Random seed for reproducibility	-
`num_images`	integer	Number of images to generate (1-4) min: 1 \| max: 4	`1`
`background`	enum	opaque makes a normal image. transparent returns a PNG with a see-through background, for stickers, logos and product cutouts. `opaquetransparent`	`opaque`

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to image_urls automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Supported Aspect Ratios

1:1

16:9

9:16

4:3

3:4

3:2

2:3

21:9

Code Examples

Text → image: copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/seedream-5-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A neon sign that reads \"OPEN LATE\" above a ramen bar at night, rain on the street",
    "image_size": "landscape_16_9"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-11-13T18:02:56Z"
}

Completed Response