图片制作
✅ 文本生成图片(T2I) ✅ 图片编辑(I2I) ✅ 多图融合 ✅ 批量生成多张图片 ✅ - `NEWAPI_API_KEY`: New API访问密钥(必需) - `BASE_URL`: 自定义API端点(可选,默认:https://docs.newapi.pro/v1) ✅ 支持所有Seedream模型
skillhub install @user_a0de7824/tupian
README 文档
3,023 字name: newapi-image-generate description: 基于New API的OpenAI兼容格式图像生成技能。支持文本生成图片、图片编辑等功能,完全兼容New API图像生成接口规范。 official: false version: 1.0.0
New API 图像生成技能
基于New API的OpenAI兼容格式图像生成工具,支持文本生成图片、图片编辑等多种创作模式,完全遵循New API图像生成接口规范。
配置
- Base URL:
https://your-new-api-server-address/v1(默认使用New API官方地址) - API Key: 从环境变量
NEWAPIAPIKEY读取 - 认证方式:
Authorization: Bearer {API_KEY} - API规范: 完全兼容OpenAI
/v1/images/generations接口格式
快速开始
第一步:设置 API Key
# macOS / Linux - 当前终端临时生效
export NEWAPI_API_KEY="你的New API密钥"
# Windows PowerShell - 当前会话临时生效
$env:NEWAPI_API_KEY="你的New API密钥"
# 验证设置成功
echo $NEWAPI_API_KEY
第二步:生成你的第一张图片
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "一只可爱的橘色小猫"
前置依赖
- Node.js 16+ 或 LobsterAI 内置运行时
- 无需额外安装依赖,脚本自动兼容环境
工作流程
- 参数解析 - 解析命令行参数,验证输入合法性
- API请求 - 按照New API格式构造请求,发送到图像生成接口
- 结果处理 - 接收并下载生成的图片文件
- 输出保存 - 将生成的图片保存到指定路径
支持的功能
1. 文本生成图片(T2I)
根据文字描述生成图片,支持所有兼容OpenAI格式的模型。
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "赛博朋克风格,未来城市夜景,霓虹灯闪烁"
--size "1024x1024"
--output cyberpunk_city.png
2. 图片编辑(I2I)
基于已有图片进行编辑,支持本地图片和网络URL。
# 使用本地图片
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "将背景改为海边日落"
--image "/path/to/your/image.jpg"
--output edited_image.png
# 使用网络图片
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "添加卡通滤镜效果"
--image "https://example.com/photo.jpg"
--output filtered_photo.png
3. 多图融合
融合多张参考图的特征生成新图像。
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "将人物服装替换为参考图中的服装"
--image "/path/to/person.jpg" \
--image "https://example.com/clothes.jpg" \
--output fusion_result.png
4. 批量生成图片
生成多张内容关联的图片。
bash "$SKILLS_ROOT/newapi-image-generate/scripts/generate-image.sh" \
--prompt "生成4张不同角度的产品展示图"
--n 4 \
--output product_shot.png
参数说明
必需参数
| 参数 | 说明 | 示例 |
|---|---|---|
--prompt | 图片描述提示词(必需) | "一只可爱的小猫" |
可选参数
| 参数 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
--image | 参考图片路径或URL(可多次使用) | 无 | 本地文件路径或URL |
--model | 模型ID | gpt-image-1 | dall-e-2, dall-e-3, gpt-image-1 |
--size | 图片尺寸 | 1024x1024 | 参考New API文档 |
--n | 生成图片数量 | 1 | 1-10 |
--quality | 图片质量 | standard | standard, hd |
--response_format | 返回格式 | url | url, b64_json |
--user | 唯一用户标识 | 无 | 任意字符串 |
--background | 背景透明度 | 无 | 透明, 不透明, 自动(仅gpt-image-1) |
--moderation | 内容审核级别 | 自动 | 低, 自动(仅gpt-image-1) |
--output | 输出文件路径 | generated_image.png | 文件路径 |
--timeout | 请求超时时间(秒) | 300 | 60-600 |
模型选择
gpt-image-1(推荐)
- 模型ID:
gpt-image-1 - 特点: 最新模型,支持更多参数和更高质量
- 支持: 背景透明度、内容审核级别等高级功能
dall-e-2
- 模型ID:
dall-e-2 - 特点: 成熟稳定版本
- 支持: 基础图像生成功能
dall-e-3
- 模型ID:
dall-e-3 - 特点: 更高质量的图像生成
- 限制: 仅支持n=1
错误处理
常见错误及解决方案
错误:未设置环境变量 NEWAPIAPIKEY
- 原因:未配置API密钥
- 解决:按照"快速开始"中的说明设置环境变量
错误:API请求失败(401)
- 原因:API Key无效或已过期
- 解决:检查API Key是否正确,重新生成密钥
错误:API请求失败(400)
- 原因:参数错误(如提示词为空、尺寸不支持等)
- 解决:检查参数是否符合New API文档要求
错误:任务超时
- 原因:生成时间过长或API繁忙
- 解决:增加
--timeout参数值,或稍后重试
错误:限流(429)
- 原因:超过请求频率限制
- 解决:等待一段时间后重试,或升级配额
输出格式
生成的图片具有以下特征:
- 格式: PNG/JPEG/WebP
- 分辨率: 根据
size参数自动调整 - 文件大小: 约0.5-10MB
- 命名规则:
- 单图:指定的文件名
- 批量:
文件名1.png,文件名2.png, ...
提示词最佳实践
优秀提示词要素
- 主体描述: 明确画面的主要内容
- 风格指定: 写实、卡通、赛博朋克等
- 细节补充: 色彩、光线、氛围等
- 构图说明: 特写、全景、俯视等视角
示例提示词
写实风格,一只橘色小猫坐在木制窗台上,阳光从左侧洒进来,温暖治愈的氛围,特写构图
参考资料
- New API文档: https://docs.newapi.pro/zh/docs/api/ai-model/images/openai/post-v1-images-generations
- New API官方网站: https://newapi.pro
同分类其他技能
查看全部 ›通过同一个AI创作工具完成AI图片、视频、音乐与语音创作,查找公开社交数据,编辑视觉成果,并集中查看和管理生成资产。Beatra 全能创
135 180.6万 AI音乐MV短片制作用一首歌的情绪、节奏和视觉概念,制作一个短视觉短片。这个 AI 音乐 MV 短片制作与歌曲生成视频工作流可以把音乐片段和视觉方向变成电影
15 66.1万 MiniMax H3 AI视频创作用 MiniMax H3 这款 AI视频生成器创作高质感 2K AI 视频。从文字创意出发完成文生视频,让静态图片自然动起来,用首尾画面
27 64.2万 AI数字人口播与虚拟主播视频用一张人像和一段短脚本或语音,制作有明确讲述内容的数字人口播视频。可使用现成录音,也可以先选择音色,把脚本生成旁白,让画面中的人物随声音
44 61.3万 架构图一键生成使用 ContextWeave 生成或修改架构图、流程图、思维导图和复杂信息图。适用于需要从代码、文件或自然语言中提取结构与关系并实际产
288 54.7万 海报设计工作室将一段活动描述、一张产品照片或品牌参考图,转化为抓人眼球的活动海报、宣传 banner 或社交媒体配图。这款 AI海报设计与制作工具生成
39 42.1万