{"openapi":"3.1.0","info":{"title":"Seedream 5.5 API","version":"1.0.0","description":"Generate, edit or split images asynchronously. Submit once and poll the returned task ID. One API key accesses all models and groups."},"servers":[{"url":"https://api.wanapi.app"}],"security":[{"bearerAuth":[]}],"paths":{"/seedream55/v1/images/generations":{"post":{"summary":"Create an image task","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"},"example":{"model":"seedream-5-5","prompt":"A ceramic fox teapot on linen in morning light","size":"1K"}}}},"responses":{"200":{"description":"Current task state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"400":{"description":"Invalid parameters; no generation submitted"},"401":{"description":"Authentication required"},"403":{"description":"Access or quota denied"},"429":{"description":"Rate limited"},"503":{"description":"Service or current pricing unavailable"}}}},"/seedream55/v1/tasks/{id}":{"get":{"summary":"Read an image task","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^task_[A-Za-z0-9]+$"}}],"responses":{"200":{"description":"Current task state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"404":{"description":"Task not found or not owned by this account"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","const":"seedream-5-5"},"prompt":{"type":"string"},"image":{"anyOf":[{"type":"string"},{"maxItems":10,"type":"array","items":{"type":"string"}}]},"size":{"type":"string"},"output_format":{"type":"string","enum":["png","jpeg"]},"background":{"type":"string","enum":["auto","opaque","transparent"]},"layer_decomposition":{"type":"boolean"},"layer_decomposition_options":{"type":"object","properties":{"max_images":{"type":"integer","minimum":2,"maximum":100},"text_recognition":{"type":"boolean"}},"additionalProperties":false},"optimize_prompt_options":{"type":"object","properties":{"mode":{"type":"string","const":"standard"}},"additionalProperties":false},"watermark":{"type":"boolean"},"content_filter":{"type":"boolean"}},"required":["model"],"additionalProperties":false,"allOf":[{"if":{"properties":{"layer_decomposition":{"const":true}},"required":["layer_decomposition"]},"then":{"required":["image"],"not":{"required":["background"]},"properties":{"image":{"oneOf":[{"type":"string","format":"uri"},{"type":"array","minItems":1,"maxItems":1,"items":{"type":"string","format":"uri"}}]},"size":{"type":"string","pattern":"^\\s*(?:[aA][uU][tT][oO]|1[kK]|1\\.5[kK]|2[kK])\\s*$"}}},"else":{"required":["prompt"],"properties":{"prompt":{"type":"string","pattern":"\\S"},"size":{"type":"string","pattern":"^\\s*(?:1[kK]|1\\.5[kK]|2[kK]|[0-9]{1,5}[xX][0-9]{1,5})\\s*$"}},"not":{"required":["layer_decomposition_options"]}}},{"if":{"properties":{"background":{"const":"transparent"}},"required":["background"]},"then":{"properties":{"output_format":{"const":"png"}}}}],"description":"prompt is required unless layer_decomposition is true. Layers require exactly one public image URL, size auto/1K/1.5K/2K, and no background field. Generation defaults to 2K and accepts WIDTHxHEIGHT totaling 921600–4624220 pixels, ratio 1:16–16:1. Transparent background requires PNG. Layer options require layer mode. PNG, watermark false and content_filter true are defaults. max_images defaults to 30, includes the base image and is capped at 100. text_recognition defaults to false. Media is URL-only, up to 30 MB each. Every reference is billed."},"Image":{"type":"object","required":["url","size"],"properties":{"url":{"type":"string","format":"uri"},"size":{"type":"string","pattern":"^\\d+x\\d+$"},"output_format":{"enum":["png","jpeg"]},"background":{"type":"string"},"z_index":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"bounding_box":{"type":"object","description":"absolute and normalized [left, top, right, bottom]; normalized coordinates use 0–1000."},"text_recognition":{"type":"object","description":"Optional printed text, lines, bounding boxes and styled runs. Fonts and style marks are estimates."}}},"Task":{"type":"object","required":["id","model","status"],"properties":{"id":{"type":"string"},"model":{"const":"seedream-5-5"},"status":{"enum":["processing","completed","failed"]},"created_at":{"type":"integer"},"finished_at":{"type":"integer"},"output":{"type":"object","properties":{"data":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/Image"}}}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}