Agent Skill

图片制作

✅ 文本生成图片(T2I) ✅ 图片编辑(I2I) ✅ 多图融合 ✅ 批量生成多张图片 ✅ - `NEWAPI_API_KEY`: New API访问密钥(必需) - `BASE_URL`: 自定义API端点(可选,默认:https://docs.newapi.pro/v1) ✅ 支持所有Seedream模型

设计多媒体·千千🐾·来自 skill_hub·skillhub.cn ↗
skillhub install @user_a0de7824/tupian
1 Stars·4.2万 综合热度·3,023 字文档·源站更新 2026-11-13

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 内置运行时
  • 无需额外安装依赖,脚本自动兼容环境

工作流程

  1. 参数解析 - 解析命令行参数,验证输入合法性
  2. API请求 - 按照New API格式构造请求,发送到图像生成接口
  3. 结果处理 - 接收并下载生成的图片文件
  4. 输出保存 - 将生成的图片保存到指定路径

支持的功能

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模型IDgpt-image-1dall-e-2, dall-e-3, gpt-image-1
--size图片尺寸1024x1024参考New API文档
--n生成图片数量11-10
--quality图片质量standardstandard, hd
--response_format返回格式urlurl, b64_json
--user唯一用户标识无任意字符串
--background背景透明度无透明, 不透明, 自动(仅gpt-image-1)
--moderation内容审核级别自动低, 自动(仅gpt-image-1)
--output输出文件路径generated_image.png文件路径
--timeout请求超时时间(秒)30060-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, ...

提示词最佳实践

优秀提示词要素

  1. 主体描述: 明确画面的主要内容
  2. 风格指定: 写实、卡通、赛博朋克等
  3. 细节补充: 色彩、光线、氛围等
  4. 构图说明: 特写、全景、俯视等视角

示例提示词

写实风格,一只橘色小猫坐在木制窗台上,阳光从左侧洒进来,温暖治愈的氛围,特写构图

参考资料

  • New API文档: https://docs.newapi.pro/zh/docs/api/ai-model/images/openai/post-v1-images-generations
  • New API官方网站: https://newapi.pro

同分类其他技能

查看全部 ›