Skip to content

过渡格式

本分类记录旧模型文档中使用的 Nano Banana 兼容请求结构,仅用于过渡。新接入请使用 OpenAI 兼容模型页和 API 参考

旧 endpoint

http
POST /v1/images/generate
POST /v1/images/edit

旧字段

字段替代字段说明
numn输出图片数量。
image_sizesize输出尺寸改用 OpenAI 风格值,例如 1024x1024
JSON image URLmultipart image 文件新图片编辑文档使用 POST /v1/images/edits 和表单字段。
data.url 响应data[0].url 响应新响应使用 OpenAI 图片响应结构。

旧生成示例

bash
curl https://api.pixapi.ai/v1/images/generate \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Editorial product photo of a matte black water bottle on stone",
    "num": 1,
    "image_size": "1:1"
  }'

旧编辑示例

bash
curl https://api.pixapi.ai/v1/images/edit \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Change the bottle color to warm ivory and keep the background",
    "image": "https://example.com/input.png",
    "num": 1
  }'

旧响应

json
{
  "code": 0,
  "message": "ok",
  "data": {
    "url": "https://cdn.pixapi.ai/generated/image.png"
  }
}

num 大于 1 时,旧响应可能把 data.url 返回为数组。