SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场jimeng-api-image-gen

jimeng-api-image-gen

设计与创作

查看项目

更新于 10-15 12:11

技能介绍

Jimeng API Image Generation 是一个使用火山引擎即梦（Jimeng）4.0 API 生成高质量 AI 图像的技能，支持文本提示词生成图像，也支持基于图像输入的图生图编辑。

用途 该技能面向需要通过即梦 API 进行 AI 图像生成的场景，可用于文生图（text-to-image）与图生图（image-to-image）编辑。

环境变量配置 使用前需获取 Access Key / Secret Key，并在 ~/.zshrc 或 ~/.zshenv 中导出： export VOLC_ACCESSKEY="your_access_key_id" export VOLC_SECRETKEY="your_secret_access_key"

输出行为（重要） 图像生成成功后，必须直接将图片展示给用户，使用如下格式输出：

Generation Info:

  • Prompt: [User's original prompt]
  • Size: [Image dimensions]
  • Save Path: [Local file path, if applicable]

示例输出： Shiba Inu under cherry blossoms

Generation Info:

  • Prompt: Shiba Inu under cherry blossom tree, warm sunlight, healing art style
  • Size: 2304 × 1728
  • Save Path: /generated_images/[Generated Image]

说明：优先使用 Markdown 图片语法 直接展示图片；同时提供在线链接以便复制和分享；若保存到本地，则展示本地文件路径；若有多张图片，逐张展示并标注编号。

快速开始 第一步：运行生成

Text-to-image

scripts/generate_image.py "A white Siamese cat sitting on a windowsill, sunlight streaming in"

With specific size

scripts/generate_image.py "Mountain sunset landscape" --size 2K

Image-to-image editing

scripts/generate_image.py "Change to watercolor style" --images https://example.com/input.jpg

Save to file

scripts/generate_image.py "Serene lake at sunset" --output /generated_images/lake.png

API 配置

  • Endpoint：https://visual.volcengineapi.com（API base URL）
  • Submit Action：CVSync2AsyncSubmitTask（提交异步生成任务）
  • Query Action：CVSync2AsyncGetResult（查询任务结果）
  • Version：2022-08-31（API 版本）
  • Service：cv（签名用服务名）
  • Region：cn-north-1（签名用区域）
  • req_key：jimeng_t2i_v40（即梦 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] 区间内
  • 宽高比（width/height）处于 [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 Generated”水印 --scale FLOAT 文本影响度 0-1（默认：0.5） --force-single 强制输出单张图片 --output PATH 将图片下载到文件 --json 输出原始 JSON 响应

环境变量： 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）。签名流程：

  1. 构建包含以下请求头的规范请求：content-type;host;x-content-sha256;x-date
  2. 计算规范请求的 SHA256 哈希
  3. 派生签名密钥：secret_key → date → region → service → "request"
  4. 使用派生密钥对待签名字符串签名
  5. 在请求中加入 Authorization 头

参考：HTTP 请求示例。

错误码

  • 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，超出速率限制，稍后重试
  • 50500：Internal Error，服务器错误
  • timeout：请求超时，可增大 JIMENG_API_TIMEOUT

输入/输出限制 输入图片：

  • 格式：仅支持 JPEG、PNG
  • 最大文件数：10 张
  • 最大大小：每张 15MB
  • 最大分辨率：4096×4096
  • 宽高比（W/H）：[1/3, 3]

输出：

  • 最大图片数：15 -（输入图片数量）
  • 格式：PNG
  • URL 有效期：24 小时

参考文档：即梦 AI 4.0 API 文档、HTTP 请求示例、火山引擎控制台、API Key 管理。

适用场景与限制 适用于需要文生图或图生图编辑的 AI 图像生成任务，需具备火山引擎访问密钥并完成环境变量配置。使用受输入图片格式、数量、大小、分辨率与宽高比限制，以及输出图片数量与 URL 有效期（24 小时）约束；内容检查未通过或速率超限时会产生对应错误码。价格、收费等未在资料中提供。