{"id":"c633fb18-adfb-4408-b8f7-4a1c7c53fc38","shortId":"FAsHLX","kind":"skill","title":"seedream-image","tagline":"Generate and edit AI images with Seedream (ByteDance) via AceDataCloud API. Use when creating images from text prompts, editing existing images, or working with high-resolution outputs. Supports Seedream 3.0 T2I, 4.0, 4.5, 5.0, and SeedEdit 3.0 models.","description":"# Seedream Image Generation\n\nGenerate and edit AI images through AceDataCloud's Seedream (ByteDance) API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/seedream/images \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a cyberpunk cat wearing VR goggles in a neon city\", \"model\": \"doubao-seedream-5-0-260128\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /seedream/tasks` with `{\"id\": \"...\"}`.\n## Models\n\n| Model | Version | Best For |\n|-------|---------|----------|\n| `doubao-seedream-5-0-260128` | Seedream 5.0 | Latest, highest quality (default) |\n| `doubao-seedream-4-5-251128` | Seedream 4.5 | High quality, balanced |\n| `doubao-seedream-4-0-250828` | Seedream 4.0 | Reliable generation |\n| `doubao-seedream-3-0-t2i-250415` | Seedream 3.0 T2I | Text-to-image, precise prompt following |\n| `doubao-seededit-3-0-i2i-250628` | SeedEdit 3.0 | Image-to-image editing |\n\n## Workflows\n\n### 1. Text-to-Image\n\n```json\nPOST /seedream/images\n{\n  \"prompt\": \"a serene Japanese garden with cherry blossoms and a red bridge\",\n  \"model\": \"doubao-seedream-5-0-260128\",\n  \"size\": \"1K\"\n}\n```\n\n### 2. Image Editing (Image-to-Image)\n\nEdit an existing image by providing the source image URL(s) and a descriptive prompt. Use the `doubao-seededit-3-0-i2i-250628` model for best editing results.\n\n```json\nPOST /seedream/images\n{\n  \"prompt\": \"change the sky to a golden sunset\",\n  \"model\": \"doubao-seededit-3-0-i2i-250628\",\n  \"image\": [\"https://example.com/photo.jpg\"]\n}\n```\n\n### 3. Async Generation with Task Polling\n\nPass a `callback_url` to receive results asynchronously via webhook, or poll `/seedream/tasks` for the result:\n\n```json\nPOST /seedream/images\n{\n  \"prompt\": \"an epic fantasy landscape\",\n  \"model\": \"doubao-seedream-5-0-260128\",\n  \"callback_url\": \"https://api.acedata.cloud/health\"\n}\n```\n\nPoll the returned `task_id`:\n\n```json\nPOST /seedream/tasks\n{\"id\": \"<task_id>\"}\n```\n\n## Parameters\n\n### Generation\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `model` | see Models table | Model to use (required) |\n| `prompt` | string | Image description (required) |\n| `size` | `\"1K\"`, `\"2K\"`, `\"3K\"`, `\"4K\"`, `\"adaptive\"` | Output resolution (e.g. `1K`=1024px, `2K`=2048px); `3K` only for Seedream 5.0 |\n| `seed` | integer [-1, 2147483647] | Seed for reproducibility (Seedream 3.0 T2I / SeedEdit 3.0 only) |\n| `guidance_scale` | number [1, 10] | Prompt adherence strength (3.0 models only; T2I default 2.5, edit default 5.5) |\n| `sequential_image_generation` | `\"auto\"`, `\"disabled\"` | Generate related images in sequence (5.0, 4.5, 4.0 only) |\n| `stream` | boolean | Stream images as they're generated (5.0, 4.5, 4.0 only) |\n| `watermark` | boolean | Add AI-generated watermark (default: true) |\n| `output_format` | `\"jpeg\"`, `\"png\"` | Output file format (Seedream 5.0 only; default: jpeg) |\n| `response_format` | `\"url\"`, `\"b64_json\"` | Response format (default: url) |\n| `tools` | array | Enable tools, e.g. `[{\"type\": \"web_search\"}]` (Seedream 5.0 only) |\n| `callback_url` | string | Webhook URL for async delivery; returns `task_id` immediately |\n\n### Editing\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `image` | Yes (for editing) | Array of image URLs or base64 strings (max 10MB each) |\n| `prompt` | Yes | Describe the desired edit |\n\n## Gotchas\n\n- Model names now use the `doubao-*` naming convention (e.g. `doubao-seedream-5-0-260128`)\n- Image editing uses the same `/seedream/images` endpoint with the `image` array parameter (no separate edit endpoint)\n- `size` replaces separate `width`/`height` params; use `\"1K\"` for 1024×1024, `\"2K\"` for 2048×2048, etc.\n- `3K` size is only supported by Seedream 5.0; `adaptive` selects the best aspect ratio automatically\n- `seed` only works with `doubao-seedream-3-0-t2i-250415` and `doubao-seededit-3-0-i2i-250628`\n- `guidance_scale` is only available for the 3.0-series models\n- `stream` and `sequential_image_generation` are only available for Seedream 5.0, 4.5, and 4.0\n- Pass `callback_url` to get a `task_id` immediately and avoid blocking; poll `/seedream/tasks` for the result — use `\"https://api.acedata.cloud/health\"` as a placeholder to force async mode without a real webhook\n\n> **MCP:** `pip install mcp-seedream` | Hosted: `https://seedream.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["seedream","image","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-seedream-image","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/seedream-image","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (4,540 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:03.645Z","embedding":null,"createdAt":"2026-05-18T13:21:34.529Z","updatedAt":"2026-05-18T19:14:03.645Z","lastSeenAt":"2026-05-18T19:14:03.645Z","tsv":"'-0':101,124,147,157,174,210,242,266,308,507,564,572 '-1':362 '-250415':159,566 '-250628':176,244,268,574 '-250828':148 '-251128':137 '-260128':102,125,211,309,508 '-5':136 '/_shared/async-tasks.md':108 '/_shared/authentication.md':60 '/_shared/mcp-servers.md':645 '/health':314,619 '/mcp':640 '/photo.jpg':272 '/seedream/images':72,192,252,297,514 '/seedream/tasks':112,291,322,612 '1':185,376 '10':377 '1024':534,535 '1024px':352 '10mb':485 '1k':213,343,351,532 '2':214 '2.5':386 '2048':538,539 '2048px':354 '2147483647':363 '2k':344,353,536 '3':156,173,241,265,273,563,571 '3.0':34,41,161,178,368,371,381,582 '3k':345,355,541 '4':135,146 '4.0':36,150,402,414,598 '4.5':37,139,401,413,596 '4k':346 '5':100,123,209,307,506 '5.0':38,127,359,400,412,433,455,548,595 '5.5':389 'acedatacloud':13,52,76 'adapt':347,549 'add':418 'adher':379 'ai':7,49,420 'ai-gener':419 'api':14,56,77 'api.acedata.cloud':71,313,618 'api.acedata.cloud/health':312,617 'api.acedata.cloud/seedream/images':70 'application/json':83 'array':447,477,519 'aspect':553 'async':103,105,274,463,625 'asynchron':286 'authent':59 'author':74 'auto':393 'automat':555 'avail':579,592 'avoid':609 'b64':440 'balanc':142 'base64':482 'bash':66 'bearer':75 'best':118,247,552 'block':610 'blossom':200 'boolean':405,417 'bridg':204 'byted':11,55 'callback':281,310,457,600 'cat':88 'chang':254 'cherri':199 'citi':95 'content':81 'content-typ':80 'convent':501 'creat':17 'curl':67 'cyberpunk':87 'd':84 'default':131,385,388,423,435,444 'deliveri':464 'describ':489 'descript':234,328,340,472 'desir':491 'disabl':394 'doubao':98,121,133,144,154,171,207,239,263,305,499,504,561,569 'doubao-seededit':170,238,262,568 'doubao-seedream':97,120,132,143,153,206,304,503,560 'e.g':350,450,502 'edit':6,22,48,183,216,221,248,387,469,476,492,510,523 'enabl':448 'endpoint':515,524 'epic':300 'etc':540 'example.com':271 'example.com/photo.jpg':270 'exist':23,223 'fantasi':301 'file':430 'follow':169 'forc':624 'format':426,431,438,443 'garden':197 'generat':4,45,46,152,275,325,392,395,411,421,589 'get':603 'goggl':91 'golden':259 'gotcha':493 'guidanc':373,575 'h':73,79 'height':529 'high':29,140 'high-resolut':28 'highest':129 'host':637 'i2i':175,243,267,573 'id':114,319,323,467,606 'imag':3,8,18,24,44,50,166,180,182,189,215,218,220,224,229,269,339,391,397,407,473,479,509,518,588 'image-to-imag':179,217 'immedi':468,607 'instal':633 'integ':361 'japanes':196 'jpeg':427,436 'json':190,250,295,320,441 'landscap':302 'latest':128 'max':484 'mcp':631,635,643 'mcp-seedream':634 'mode':626 'model':42,96,115,116,205,245,261,303,329,331,333,382,494,584 'name':495,500 'neon':94 'number':375 'output':31,348,425,429 'param':530 'paramet':324,326,470,520 'pass':279,599 'pip':632 'placehold':622 'png':428 'poll':107,109,278,290,315,611 'post':69,111,191,251,296,321 'precis':167 'prompt':21,85,168,193,235,253,298,337,378,487 'provid':226 'qualiti':130,141 'quick':64 'ratio':554 're':410 'real':629 'receiv':284 'red':203 'relat':396 'reliabl':151 'replac':526 'reproduc':366 'requir':336,341,471 'resolut':30,349 'respons':437,442 'result':249,285,294,615 'return':317,465 'scale':374,576 'search':453 'see':58,104,330,641 'seed':360,364,556 'seededit':40,172,177,240,264,370,570 'seedream':2,10,33,43,54,99,122,126,134,138,145,149,155,160,208,306,358,367,432,454,505,547,562,594,636 'seedream-imag':1 'seedream.mcp.acedata.cloud':639 'seedream.mcp.acedata.cloud/mcp':638 'select':550 'separ':522,527 'sequenc':399 'sequenti':390,587 'seren':195 'seri':583 'server':644 'setup':57,63 'size':212,342,525,542 'skill' 'skill-seedream-image' 'sky':256 'sourc':228 'source-acedatacloud' 'start':65 'stream':404,406,585 'strength':380 'string':338,459,483 'sunset':260 'support':32,545 't2i':35,158,162,369,384,565 'tabl':332 'task':106,277,318,466,605 'text':20,164,187 'text-to-imag':163,186 'token':62,78 'tool':446,449 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'true':424 'type':82,451 'url':230,282,311,439,445,458,461,480,601 'use':15,236,335,497,511,531,616 'valu':327 'version':117 'via':12,110,287 'vr':90 'watermark':416,422 'wear':89 'web':452 'webhook':288,460,630 'width':528 'without':627 'work':26,558 'workflow':184 'x':68 'yes':474,488","prices":[{"id":"686b9d23-f99e-4c18-b640-e2009641748a","listingId":"c633fb18-adfb-4408-b8f7-4a1c7c53fc38","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:34.529Z"}],"sources":[{"listingId":"c633fb18-adfb-4408-b8f7-4a1c7c53fc38","source":"github","sourceId":"AceDataCloud/Skills/seedream-image","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/seedream-image","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:34.529Z","lastSeenAt":"2026-05-18T19:14:03.645Z"}],"details":{"listingId":"c633fb18-adfb-4408-b8f7-4a1c7c53fc38","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"seedream-image","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"118e4eae7a1a07c8168ed26199169b808f5d74b1","skill_md_path":"skills/seedream-image/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/seedream-image"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"seedream-image","license":"Apache-2.0","description":"Generate and edit AI images with Seedream (ByteDance) via AceDataCloud API. Use when creating images from text prompts, editing existing images, or working with high-resolution outputs. Supports Seedream 3.0 T2I, 4.0, 4.5, 5.0, and SeedEdit 3.0 models.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-seedream for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/seedream-image"},"updatedAt":"2026-05-18T19:14:03.645Z"}}