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} - 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
错误处理
常见错误及解决方案
错误：未设置环境变量 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, ...
提示词最佳实践
优秀提示词要素
- 主体描述: 明确画面的主要内容
- 风格指定: 写实、卡通、赛博朋克等
- 细节补充: 色彩、光线、氛围等
- 构图说明: 特写、全景、俯视等视角
示例提示词
写实风格，一只橘色小猫坐在木制窗台上，阳光从左侧洒进来，温暖治愈的氛围，特写构图
参考资料
- New API文档: https://docs.newapi.pro/zh/docs/api/ai-model/images/openai/post-v1-images-generations
- New API官方网站: https://newapi.pro
