图片通用说明

​

接口

POST https://token.poryf.com/v1/images/generations
POST https://token.poryf.com/v1/images/edits

• /v1/images/generations：文生图；带 image 参考图时为图生图。
• /v1/images/edits：图片编辑，image 必填。

​

请求字段

​

各系列参数

• Nano Banana：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。nano-banana-2 和 nano-banana-2-lite 另外支持 1:4、4:1、1:8、8:1 超宽比例。
• 可灵图片：16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9。

• quality 可选 low、medium、high。GPT Image 2.5 另有 xhigh、max。
• 画质越高、尺寸越大，消耗的 token 越多，出图也越慢。

​

示例：文生图

curl https://token.poryf.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "秋日咖啡店的拿铁海报，暖色调，留出标题位置",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://token.poryf.com/v1",
    timeout=300,
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="秋日咖啡店的拿铁海报，暖色调，留出标题位置",
    size="1024x1024",
    quality="low",
)
print(result.data[0].url or result.data[0].b64_json[:32])

​

示例：参考图生图

curl https://token.poryf.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "把这张产品图换成纯白背景，保持商品不变",
    "image": ["https://example.com/product.jpg"]
  }'

​

响应

{
  "data": [
    { "url": "https://example.com/generated/xxxx.png" }
  ]
}

• Nano Banana 与可灵返回 url。可灵一次生成多张时，data 中有多项。
• GPT Image 实测返回 url，同时带一个空的 b64_json 字段，读取时取非空的那个。

​

计费

• GPT Image：按 token 计费，包括输入文本、输入图片和输出图片的 token。尺寸越大、画质越高越贵。参考价格：1024 低画质约 ¥0.03 / 张，中画质约 ¥0.06 / 张，4K 最高画质约 ¥1.9 / 张。图片编辑另计输入图片的 token，带一张 1024 参考图、低画质约 ¥0.07 / 张。
• Nano Banana：按张计费，按 1K / 2K / 4K 分档。
• 可灵图片：按张计费。kling-image-2.1 按文生图、单图参考、多图参考分档。

​

常见错误