指南：生成與編輯圖片

用文字生成圖片、以參考圖修改照片、使用去背、放大與清除工具——附模型選擇與費用。

圖片是最快、最便宜的生成類型，也最適合用來熟悉 API。多數圖片模型一分鐘內就能出圖，所以可以加上 ?wait=60，在同一個回應裡直接取得圖片。

文字生成圖片

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "black-forest-labs/flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Product photo of a ceramic coffee mug on a linen tablecloth, soft window light, shallow depth of field",
      "aspect_ratio": "4:3"
    }
  }'

結果在 data.output.assets[0].url。如果回傳的是 202，代表模型花了超過 60 秒；用 recordInfo 讀取任務即可。

該選哪個模型

你想要	試試	原因
最快、最便宜的草稿	`alibaba/z-image-turbo/text-to-image`	約十秒，每張一兩點
價格低、整體品質好	`black-forest-labs/flux-2-klein-9b/text-to-image`	快速、清晰、很聽提示詞的話
清楚的文字、海報、圖表	`google/nano-banana-2.1/text-to-image`、`openai/gpt-image-2/text-to-image`	擅長文字與版面，最高 4K
一次出多張選擇	有 `num_outputs` 的模型	一個任務產生多張圖

價格依模型與選項而不同。模型頁列出每個模型的起始價格，模型的參考頁列出所有級距。

用參考圖編輯

編輯模型以 /edit 結尾，來源圖片放在 image_urls，順序與你在提示詞中提到它們的順序一致：

{
  "model": "google/nano-banana-2.1/edit",
  "input": {
    "prompt": "Turn the scene into a bright summer afternoon and keep the composition",
    "image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"]
  }
}

除了說明要改什麼，也要說清楚哪些保持不變；編輯模型會照字面理解「保留臉部與姿勢」。
有多張參考圖時，請依位置稱呼：「把第二張圖的外套穿到第一張圖的人身上」。
本機檔案要先上傳；重複使用的檔案請放進素材庫。

一步完成的工具

PopNow 自家的工具只需要一張圖，不用寫提示詞：

模型 ID	作用
`popnow/background-remover-v1/edit`	把主體去背到透明背景上
`popnow/image-upscaler-v1/upscale`	放大並銳利化圖片
`popnow/object-eraser-v1/edit`	移除你指定的物件
`popnow/image-expander-v1/edit`	把畫面往外延伸

{ "model": "popnow/background-remover-v1/edit",
  "input": { "image_url": "https://media.popnow.ai/movie/lighthouse.webp" } }

值得注意的設定

aspect_ratio 與 resolution 是最常影響價格的兩個設定。不確定時請先問 jobs/quote。
seed：不傳就會隨機挑一個並寫回任務的 input。想要與滿意結果相近的變化，就把這個數字傳回去；固定種子讓多次執行便於比較，但不保證完全相同。
output_format：png 保留透明與細節；jpeg 檔案較小。
不認得的設定會被拒絕，所以請查看這個模型自己的 schema，不要從別的模型照抄。

好用的提示詞

像向攝影師或插畫家交代需求那樣描述畫面：主體、場景、構圖、光線、風格。「一只陶瓷馬克杯，俯拍，放在亞麻布上，清晨窗光，低飽和色調」比「一張好看的杯子照片」好得多。最重要的放最前面，別堆一長串互相衝突的風格詞。

可能遇到的錯誤

content_rejected：模型拒絕了提示詞或參考圖。換個說法或換個模型。
invalid_asset：參考圖無法讀取。確認連結回傳的是圖片本身，或改為上傳檔案。
unsupported_combination：這個模型目前不支援這組設定；修改錯誤訊息中指出的那一項。

以上情況都會釋放保留的點數，所以失敗的圖片不需付費。