volcengine-image-studio

Use this skill to actually generate images through a Volcengine/ARK-compatible image endpoint.

中文说明

这是一个面向 火山引擎 / ARK 兼容图片生成接口 的实战型 skill，不只是帮你写提示词，而是直接把图片生成跑起来。

适用场景包括：

• - 生成海报、宣传图、配图
• 文生图
• 单张或多张参考图生图
• 直接使用本地图片作为输入
• 一次生成多张结果图
• 自动下载生成结果到本地

Default path

Run the bundled script:

CODEBLOCK0

By default, URL results are auto-downloaded to Desktop. For multi-image runs, the script creates a new folder per run automatically and opens that folder in Finder.

Required config

The script reads config from env vars:

• - VOLCENGINE_API_KEY or INLINECODE1
• INLINECODE2 or INLINECODE3
• INLINECODE4 or INLINECODE5

Supported modes

1. Text to image

CODEBLOCK1

2. One local reference image → one new image

CODEBLOCK2

3. One reference image URL → one new image

CODEBLOCK3

4. One reference image → multiple new images

CODEBLOCK4

5. Multiple reference images → multiple new images

CODEBLOCK5

You can also pass a local text file of URLs/paths:

CODEBLOCK6

Local image path support

• - --image ~/Desktop/ref.png → automatically converted to a data: URL with base64
• INLINECODE8 → sent as-is
• INLINECODE9 → sent as-is

This lets you use local files directly without manually converting them.

Auto-download behavior

When the API returns image URLs, the script downloads them to Desktop by default.

Example download behavior:

• - Single image: INLINECODE10
• Multi-image run: INLINECODE11

Disable auto-download if needed:

CODEBLOCK7

Custom download directory:

CODEBLOCK8

Force a new folder even for single-image runs:

CODEBLOCK9

Disable per-run folders:

CODEBLOCK10

Disable auto-opening Finder:

CODEBLOCK11

Optional env vars

• - VOLCENGINE_IMAGE_SIZE (example: 2K)
• INLINECODE14 (default 1)
• INLINECODE16 (default standard)
• INLINECODE18 (default url)
• INLINECODE20 (disabled / auto)
• INLINECODE23 (example: 3)
• INLINECODE25 (true / false)
• INLINECODE28 (true / false)
• INLINECODE31 (default generated-images)
• INLINECODE33 (default true)
• INLINECODE35 (default ~/Desktop)
• INLINECODE37 (auto / true / false, default auto)
• INLINECODE42 (auto / true / false, default auto)
• INLINECODE47 (default 120)

Execution checklist

1. 1. Confirm prompt, target style, and whether reference images are needed.
2. Add --image once for single-reference generation, or repeat it for multi-reference generation.
3. For local images, pass the local path directly; the script converts it to base64 data URL automatically.
4. For single-image-to-multi-image and multi-reference sequences, set --sequential-image-generation auto and --sequential-max-images <N>.
5. Use --stream true when the API returns incremental image events.
6. By default, returned image URLs are downloaded to Desktop; multi-image runs go into a new folder automatically.
7. Mention the downloaded paths or folder path in the result.
8. For multi-image runs, let Finder open the created folder unless the user disabled it.
9. If it fails, surface the exact HTTP error or missing field.

Release positioning

Compared with an earlier bare-bones generation flow, this version is packaged around the logic that proved usable in practice:

• - supports Volcengine / ARK-compatible endpoint patterns
• supports reference-image workflows, including local files
• supports sequential multi-image generation
• supports automatic result download and run-based folder grouping
• better fits poster and commercial visual production

Troubleshooting

• - Missing key → set INLINECODE53
• Missing model → set INLINECODE54
• Missing endpoint → set INLINECODE55
• Local file not found → check the --image path
• 401/403 → key invalid or lacks permission
• 404/405 → endpoint wrong
• 400 → model/size/request body incompatible with the target API
• No returned files/URLs → inspect raw in the JSON output

References

• - INLINECODE58

• - 401/403 → key invalid or lacks permission
• 404/405 → endpoint wrong
• 400 → model/size/request body incompatible with the target API
• No returned files/URLs → inspect raw in the JSON output

References

• - INLINECODE61

References

• - INLINECODE63