К основному содержанию
скилл CX Codex

seedream-image — скилл для Claude Code: что делает и установка

Скилл seedream-image для Claude Code подключает Seedream 5.0 для генерации, редактирования и разложения изображений на слои. Обрабатывает референсы, создаёт изображения с прозрачным фоном и серии картинок.

Apache-2.0 235 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill seedream-image -a claude-code
Открыть на GitHub

Что делает seedream-image

seedream-image отправляет запросы в Seedream 5.0 через AceDataCloud: создаёт изображения по тексту, редактирует изображения по URL или Base64, собирает связанные наборы и поддерживает потоковую выдачу. Модель Lite умеет веб-поиск и серии изображений, а Pro работает с разложением на редактируемые слои и прозрачным фоном.

Внутри описаны REST-запросы, асинхронные задачи, потоковые события, а также команды для mcp-seedream-pro и seedream-cli. Для разложения нужен ровно один PNG или JPEG, функция доступна только в Pro. Результаты по URL быстро истекают, поэтому файлы нужно сохранять сразу.

Без ACEDATACLOUD_API_TOKEN запросы к API не выполнятся. Для асинхронной генерации скилл советует получать task_id и опрашивать ту же задачу, а не отправлять повторный платный запрос.

Какие задачи решает

  • сгенерировать изображение по текстовому описанию
  • отредактировать картинку по референсу
  • собрать связанную серию изображений
  • сделать фон прозрачным в PNG
  • разложить изображение на редактируемые слои

Примеры запросов агенту

  • Сгенерируй через seedream-image четыре связанных изображения курьера в дождливом неоновом городе.
  • Отредактируй изображение по URL, замени попугая на павлина и сохрани прозрачный фон в PNG.
  • Разложи poster.png на слои через модель Pro и верни координаты каждого слоя.

Как установить seedream-image

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill seedream-image -a claude-code

2Вручную: положить файлы

~/.claude/skills/seedream-image/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/seedream-image/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о seedream-image

Как установить seedream-image в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill seedream-image -a claude-code, затем проверьте файл ~/.claude/skills/seedream-image/SKILL.md.

Что делает seedream-image?

Скилл подключает Seedream 5.0 через AceDataCloud для генерации и редактирования изображений, потоковой выдачи, связанных наборов и разложения картинки на слои.

Что нужно для работы seedream-image?

Нужен ключ AceDataCloud в переменной ACEDATACLOUD_API_TOKEN. Разложение на слои доступно только модели Pro и принимает ровно один PNG или JPEG.

Исходный текст

SKILL.md · Apache-2.0
---
name: seedream-image
description: Generate, edit, stream, or decompose images with Seedream 5.0 via AceDataCloud. Use for text-to-image, reference-image editing, related image sets, transparent-background edits, or editable layer extraction.
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.1"
compatibility: Requires ACEDATACLOUD_API_TOKEN (get an API key at https://platform.acedata.cloud/console/applications). Optionally pair with mcp-seedream-pro or seedream-cli.
---

# Seedream Image

Use `POST https://api.acedata.cloud/seedream/images`. Authenticate with `Authorization: Bearer $ACEDATACLOUD_API_TOKEN` and JSON request bodies.

## First-time setup

1. Install the official Skill with `clawhub install @acedatacloud/seedream`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Seedream access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
3. If you enable **Allowed APIs** restrictions, include `/seedream/images` and `/seedream/tasks`. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
5. Follow the **Generate or edit** example below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.

[Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)

## Pick the model from the requested capability

| Capability | Seedream 5.0 Pro | Seedream 5.0 Lite |
|---|---|---|
| Model ID | `doubao-seedream-5-0-pro-260628` | `doubao-seedream-5-0-lite-260128` |
| Generate/edit one image | Yes | Yes |
| Reference images | Up to 10 | Up to 14 |
| Related image set | No | Yes; input + output ≤ 15 |
| Streaming / web search | No | Yes |
| Layer decomposition / transparent background | Yes | No |
| Prompt optimization | `standard`, `fast` | `standard` |
| Preset sizes | `1K`, `1.5K`, `2K` | `2K`, `3K`, `4K` |

Seedream 4.5 and 4.0 remain available for compatibility. Do not send a parameter to a model that does not support it.

## Generate or edit

```bash
curl https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-lite-260128",
    "prompt": "a four-panel storyboard of a courier crossing a rainy neon city",
    "size": "2K",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {"max_images": 4},
    "watermark": false
  }'
```

For editing, add `image` as one URL/Base64 string or an array. `response_format` is `url` or `b64_json`; 5.0 Pro/Lite also support `output_format` as `jpeg` or `png`. Explicit dimensions use `WIDTHxHEIGHT` and must satisfy the selected model's pixel and aspect-ratio limits.

Use Lite web search only when current information matters:

```json
{"tools": [{"type": "web_search"}]}
```

## Transparent-background Pro edit

Use one transparent PNG input and PNG output:

```json
{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "replace the parrot with a peacock",
  "image": "https://example.com/layer.png",
  "background": "transparent",
  "output_format": "png",
  "size": "1.5K"
}
```

Do not combine `background` with layer decomposition. `transparent` with JPEG is invalid.

## Decompose an image into editable layers

`layer_decomposition` is Pro-only and requires exactly one PNG/JPEG. Omit `prompt` for automatic decomposition, describe desired elements in natural language, or use normalized `<bbox>` coordinates.

```bash
curl https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "image": "https://example.com/poster.png",
    "layer_decomposition": true,
    "size": "auto",
    "watermark": false
  }'
```

The response contains one base image (`z_index: 0`) and up to 16 transparent PNG layers. Each layer can include `name`, `description`, and `bounding_box.absolute`/`normalized`. To recompose, scale each layer to its bounding-box width and height, place it at left/top, and draw in ascending `z_index`. Any layer failure fails the whole decomposition.

## Async tasks

Generation can take time. Prefer `"async": true`; the response returns `task_id`. Poll using:

```json
POST /seedream/tasks
{"action": "retrieve", "id": "<task_id>"}
```

Follow [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Use `callback_url` only when a real public webhook exists. Do not use a health endpoint as a fake callback.

## Streaming

Lite/4.x support streaming. Send `"stream": true` with `Accept: application/x-ndjson`; read one normalized JSON event per line until `image_generation.completed`. Do not combine streaming with `async` or `callback_url`.

- `image_generation.partial_succeeded`: one generated image
- `image_generation.partial_failed`: one failed item; other Lite images may still succeed
- `image_generation.completed`: final usage and the only billing completion

## Agent tools

- MCP: `pip install mcp-seedream-pro`; use `seedream_generate_image`, `seedream_edit_image`, `seedream_decompose_image`, then poll with `seedream_get_task`.
- CLI: `pip install seedream-cli`; use `seedream generate`, `seedream edit`, `seedream decompose`, or `seedream generate --stream --json`.
- Hosted MCP: `https://seedream.mcp.acedata.cloud/mcp`.

MCP image tools are asynchronous, so use REST or CLI for real-time streaming.

## Result and billing safeguards

- URL results expire; persist files promptly.
- Lite `data[]` may mix successful images and per-item `error` objects. Count only successful images.
- Pro layer items are billed individually by actual output size; the base and every successful layer count separately.
- Preserve `z_index`, bounding boxes, item errors, `tools`, and `usage`; do not flatten the response to a URL list.
- Never estimate final billed cost from requested size alone. Use the returned `cost`/usage and the live pricing page: https://platform.acedata.cloud/services/seedream?tab=pricing.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
bytedance-seedream calesthio Скилл bytedance-seedream для Claude Code генерирует и редактирует изображения через Ark. Подключается к задачам с референсами, группами результатов и потоковой выдачей. CX Codex +1 136установок byted-seedream-image-generate bytedance Скилл byted-seedream-image-generate генерирует изображения из текстовых описаний через Volcano Engine Seedream. Поддерживает три версии моделей, пакетную генерацию, трансформацию стилей и веб-поиск в версии 5.0. CX Codex +1 304установок scenario-seedream scenario-labs Скилл scenario-seedream подключает модели Seedream от ByteDance через Scenario MCP для генерации, редактирования и нарезки изображений на слои прямо в чате с агентом. CX Codex +1 843установок gpt-image-v2 eachlabs Скилл gpt-image-v2 для Claude Code создаёт и редактирует изображения через EachLabs с моделями GPT Image v2. CX Codex +1 169установок ideogram-image calesthio Скилл ideogram-image для Claude Code подключает Ideogram Developer API для генерации и редактирования изображений. Включается при работе с V4, V3 и API-пайплайнами. CX Codex +1 137установок codex-image-plugin Starfall Плагин codex-image-plugin для Claude Code генерирует и редактирует растровые изображения через OpenAI-compatible image API. Работает с моделями, референсами и масками. CX Codex ★ 1 596звёзд репо

Из того же набора67

Весь набор →
flux-image Скилл flux-image генерирует и редактирует изображения через API AceDataCloud: текст в картинку, правки по описанию, видео FLUX 3. Работает через OpenClaw Gateway с ключом ACEDATACLOUD_API_TOKEN в .env. CX Codex +1 238установок wan-video Скилл wan-video генерирует видео по тексту или анимирует картинки через API AceDataCloud с моделями Wan от Alibaba. CX Codex +1 238установок producer-music Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок hailuo-video Скилл hailuo-video генерирует видео из текста или анимирует картинки через API Hailuo (MiniMax) от AceDataCloud. Работает через три модели: текст-в-видео, картинка-в-видео и режим режиссёра для точного контроля над камерой. CX Codex +1 235установок nano-banana-image Скилл nano-banana-image генерирует и правит изображения через API AceDataCloud: промпт текстом, референсы ссылками, вывод в 1K, 2K или 4K. CX Codex +1 232установок tencentcloud-cos Управляет бакетами и объектами Tencent Cloud COS: загружает, скачивает, копирует и удаляет файлы. Выполняет задачи объектного хранилища из агента. CX Codex +1 232установок google-search Скилл google-search ищет в Google страницы, картинки, новости, места и видео через API AceDataCloud и отдаёт агенту ссылки с заголовками и сниппетами. CX Codex +1 232установок google-gmail Скилл google-gmail позволяет искать письма Gmail, разбирать цепочки и работать с метками и вложениями. Отправка и архивирование требуют соответствующих разрешений и подтверждения пользователя. CX Codex +1 231установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой