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: 从环境变量 NEWAPI_API_KEY 读取
• 认证方式: Authorization: Bearer {API_KEY}

  小葱技能站7w4.net发现了升级插件。

• 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

参数说明

必需参数

可选参数

模型选择

gpt-image-1（推荐）

• 模型ID: gpt-image-1
• 特点: 最新模型，支持更多参数和更高质量
• 支持: 背景透明度、内容审核级别等高级功能

dall-e-2

• 模型ID: dall-e-2
• 特点: 成熟稳定版本
• 支持: 基础图像生成功能

dall-e-3

• 模型ID: dall-e-3
• 特点: 更高质量的图像生成
• 限制: 仅支持n=1

错误处理

常见错误及解决方案

错误：未设置环境变量 NEWAPI_API_KEY - 原因：未配置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

这个图像生成工具功能比较全面，支持文生图、图片编辑和多图融合等多种模式，文档说明详细，容易上手。但存在一些明显问题：base64 格式功能不可用，响应解析方式较简单可能影响稳定性，另外默认配置指向了文档地址而非真正的 API 服务。使用前需要正确配置 API 密钥，总体适合有一定技术基础的用户，稳定性还有提升空间。