OpenAI-Compatible Image Generations
Generate images with ByteDance Seedream via the standard POST /v1/images/generations endpoint. OpenAI-compatible request shape; minimum image size is 3,686,400 pixels (e.g., 1920×1920).
POST /v1/images/generations endpoint. Currently routed to ByteDance Seedream (seedream-4-5-251128). Wan 2.7 models do not use this path — see Image Generation via Chat.
Routing at a glance
Supported models
Size constraint ⚠️
Seedream’s upstream enforces a minimum of 3,686,400 pixels. Requests below that are rejected with:width × height ≥ 3,686,400.
Request
Request fields
Response
modelechoed at the rootdata[].size— actual dimensions of each returned imageusage— includesgenerated_images(drives billing), plusoutput_tokens/total_tokensfor token accounting
Common 4xx causes
400 InvalidParameter — image size must be at least 3686400 pixels—sizewas too small. Use1920x1920or larger.404 openai_error— you passed a model that isn’t routed through this endpoint (e.g.,wan2.7-image). Use the chat-based route instead.400 invalid_request— malformedsizestring (e.g.,1024instead of1024x1024).
Related
Image Generation via Chat
/v1/chat/completions route for the Wan 2.7 family.Gemini generateContent
Media Gen skill
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Image generation model. Currently only seedream-4-5-251128 is routed through this endpoint. Wan 2.7 models use /v1/chat/completions.
seedream-4-5-251128 Text description of the image to generate.
Number of images to generate. Each image is billed separately at the per-image rate.
x >= 1Image dimensions as WIDTHxHEIGHT. Must satisfy width × height ≥ 3,686,400. Common valid values: 1920x1920, 2048x2048, 2304x1600, 2560x1920.
"2048x2048"