火山引擎Jimeng 4.0 API图像生成工具 - AI文生图与图生图脚本

jimeng-api-image-gen by wvlvik/toy-skills

234 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/wvlvik/toy-skills --skill jimeng-api-image-gen

AI/机器学习图像处理命令行工具

🇨🇳中文介绍

Jimeng API 图像生成

使用火山引擎的 Jimeng 4.0 API，通过文本提示或图像输入生成高质量的 AI 图像。

配置环境变量

获取 Access Key/Secret Key

# ~/.zshrc or ~/.zshenv
export VOLC_ACCESSKEY="your_access_key_id"
export VOLC_SECRETKEY="your_secret_access_key"

输出行为（重要）

图像生成成功后，您必须直接向用户显示图像！

生成完成后，请按以下格式输出：

![Generated Image](IMAGE_URL)

**生成信息：**
- 提示词：[用户的原始提示词]
- 尺寸：[图像尺寸]
- 保存路径：[本地文件路径，如果适用]

示例输出

![樱花下的柴犬](https://example.com/image.png)

**生成信息：**
- 提示词：樱花树下的柴犬，温暖的阳光，治愈系艺术风格
- 尺寸：2304 × 1728
- 保存路径：/generated_images/[Generated Image] **重要**

注意事项

优先使用 Markdown 图像语法 ![描述](URL) 直接显示图像
以便于复制和分享

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 1：运行生成命令

# 文生图
scripts/generate_image.py "一只白色的暹罗猫坐在窗台上，阳光洒进来"

# 指定尺寸
scripts/generate_image.py "山间日落风景" --size 2K

# 图生图编辑
scripts/generate_image.py "改为水彩风格" --images https://example.com/input.jpg

# 保存到文件
scripts/generate_image.py "日落时宁静的湖泊" --output /generated_images/lake.png

参数	值	描述
Endpoint	`https://visual.volcengineapi.com`	API 基础 URL
Submit Action	`CVSync2AsyncSubmitTask`	提交异步生成任务
Query Action	`CVSync2AsyncGetResult`	查询任务结果
Version	`2022-08-31`	API 版本
Service	`cv`	用于签名的服务名称
Region	`cn-north-1`	用于签名的区域
req_key	`jimeng_t2i_v40`	Jimeng AI 4.0 模型标识符

预设	分辨率	像素数
1K	1024×1024	1,048,576
2K	2048×2048	4,194,304 (默认)
4K	4096×4096	16,777,216

同时使用 --width 和 --height：

scripts/generate_image.py "prompt" --width 2560 --height 1440

推荐宽高比：

1:1 (2048x2048) - 社交媒体帖子
4:3 (2304x1728) - 演示文稿
16:9 (2560x1440) - 宽屏显示器
9:16 (1440x2560) - 手机竖屏
3:2 (2496x1664) - 摄影

宽度 × 高度必须在 [1024×1024, 4096×4096] 范围内
宽高比 (宽度/高度) 必须在 [1/16, 16] 范围内
建议：使用 2K 及以上以获得更好质量

scripts/generate_image.py PROMPT [OPTIONS]

Arguments:
  PROMPT              图像生成的文本提示词（必需，最多 800 个字符）

Options:
  --size SIZE         图像尺寸：1K, 2K, 4K 或 WxH (默认: 2K)
  --width WIDTH       精确宽度（需要配合 --height 使用）
  --height HEIGHT     精确高度（需要配合 --width 使用）
  --images URL [...]  用于图生图的输入图像 URL（最多 10 张）
  --watermark         添加“AI 生成”水印
  --scale FLOAT       文本影响力 0-1 (默认: 0.5)
  --force-single      强制单张图像输出
  --output PATH       将图像下载到文件
  --json              输出原始 JSON 响应

Environment Variables:
  VOLC_ACCESSKEY           Access Key ID (必需)
  VOLC_SECRETKEY           Secret Access Key (必需)
  JIMENG_API_URL           API 端点 (默认: https://visual.volcengineapi.com)
  JIMENG_API_TIMEOUT       请求超时秒数 (默认: 120)
  JIMENG_POLL_INTERVAL     轮询间隔秒数 (默认: 2)
  JIMENG_MAX_POLL_ATTEMPTS 最大轮询尝试次数 (默认: 60)

此技能使用火山引擎 IAM v4 签名认证 (HMAC-SHA256)。签名过程如下：

使用以下标头构建规范请求：content-type;host;x-content-sha256;x-date
计算规范请求的 SHA256 哈希值
派生签名密钥：secret_key → date → region → service → "request"
使用派生密钥对待签名字符串进行签名
将 Authorization 标头添加到请求中

代码	消息	描述
10000	Success	请求成功
50411	Pre Img Risk Not Pass	输入图像内容检查未通过
50511	Post Img Risk Not Pass	输出图像内容检查未通过
50412	Text Risk Not Pass	输入文本内容检查未通过
50413	Post Text Risk Not Pass	输入文本包含敏感词
50429	Request Has Reached API Limit	达到 API 限制，请稍后重试
50500	Internal Error	服务器错误
timeout	Request timeout	增加 JIMENG_API_TIMEOUT

格式：仅限 JPEG, PNG
最大文件数：10 张图像
最大尺寸：每张图像 15MB
最大分辨率：4096×4096
宽高比 (宽/高)：[1/3, 3]

最大图像数：15 - (输入图像数量)
格式：PNG
URL 有效期：24 小时

AI 代码实施计划编写技能 | 自动化开发任务分解与 TDD 流程规划工具

48,300 周安装

火山引擎Jimeng 4.0 API图像生成工具 - AI文生图与图生图脚本

🇨🇳中文介绍

Jimeng API 图像生成

配置环境变量

输出行为（重要）

示例输出

注意事项

相关 Skills

快速开始

步骤 1：运行生成命令

API 配置

图像尺寸选项

预设分辨率

精确尺寸

命令行选项

身份验证

错误代码

输入/输出限制

参考文档

最新 Skills