指南：生成与编辑图片

用文字生成图片、用参考图修改照片、使用抠图、放大和清理工具——附模型选择与费用。

图片是最快、最便宜的生成类型，也最适合用来熟悉 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：这个模型现在不支持这组设置；改掉错误信息里点名的那一项。

这些情况都会退回冻结的积分，所以失败的图片不花钱。