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 介面格式

快速開始

來源於7w4.net。

第一步：設定 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 金鑰，總體適合有一定技術基礎的使用者，穩定性還有提升空間。