gpt-image-2.5-flare | aiftopia API 参考

Model ID: gpt-image-2.5-flare
厂商: OpenAI
模型类型: 图像模型

以下说明使用 gpt-image-2.5-flare 调用 aiftopia 的兼容接口。价格与分组在构建文档时同步自 newapi.aiftopia.com/pricing，实际账户分组和可用性以控制台为准。

#计费信息

原价

每次请求: ¥0.02 / 请求

各分组价格单位：¥ / 每次请求，按原价 × 分组倍率

分组	每次请求
default分组×1默认分组	¥0.02
绘图&视频分组×1需要绘图或视频选这个分组（按次调用，选1k/2k/4k、时长等参数都是一样的价格）	¥0.02

价格与分组同步于 2026-11-02.

#参考图编辑

POSThttps://newapi.aiftopia.com/v1/images/edits

#请求参数

参数	类型	必填	默认值	枚举值 / 约束范围	说明
`image`	`file`	是	—	maxFiles: 4	要编辑或参考的图片，可一次上传多张（如第 1 张人物、第 2 张服装）；以 multipart/form-data 文件上传，不接受 URL 字符串。
`mask`	`file`	否	—	binary	可选蒙版，透明区域标记需要重绘的位置；PNG，尺寸与参考图一致。
`prompt`	`string`	是	—	—	描述希望基于参考图生成或修改的内容。
`size`	`string`	否	`"auto"`	auto \| 1024x1024 \| 1536x1024 \| 1024x1536	输出图像的尺寸。
`quality`	`string`	否	`"auto"`	auto \| high \| medium \| low	输出图像的质量档位。
`n`	`integer`	否	`1`	1..10	生成图像数量，取值 1–10。

参考图必须用 multipart/form-data 以文件上传（-F "image=@文件"）。把图片放进 JSON 的 image_urls 字段不会生效。

#请求示例

curl -X POST "https://newapi.aiftopia.com/v1/images/edits" \
  -H "Authorization: Bearer $FOXROUTER_API_KEY" \
  -F "model=gpt-image-2.5-flare" \
  -F "prompt=A minimalist product poster of a ceramic vase, soft studio light." \
  -F "size=auto" \
  -F "image=@reference-1.png" \
  -F "image=@reference-2.png"

#在线调用

POST/v1/images/edits

API Key参考图片（最多 4 张）蒙版

浏览器直连 aiftopia，密钥仅用于本次请求，不会保存。代码区是请求参数，运行时与所选参考图一起以 multipart/form-data 提交到 POST /v1/images/edits；必须至少选择一张参考图。连通性自检

#图像生成

POSThttps://newapi.aiftopia.com/v1/images/generations

#请求参数

参数	类型	必填	默认值	枚举值 / 约束范围	说明
`prompt`	`string`	是	—	—	描述希望基于参考图生成或修改的内容。
`size`	`string`	否	`"auto"`	auto \| 1024x1024 \| 1536x1024 \| 1024x1536	输出图像的尺寸。
`quality`	`string`	否	`"auto"`	auto \| high \| medium \| low	输出图像的质量档位。
`n`	`integer`	否	`1`	1..10	生成图像数量，取值 1–10。

#请求示例

curl -X POST "https://newapi.aiftopia.com/v1/images/generations" \
  -H "Authorization: Bearer $FOXROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A minimalist product poster of a ceramic vase, soft studio light.",
    "size": "auto"
  }'

import os

import requests

url = "https://newapi.aiftopia.com/v1/images/generations"
headers = {
    "Authorization": "Bearer " + os.environ["FOXROUTER_API_KEY"],
    "Content-Type": "application/json",
}
payload = """{
  "model": "gpt-image-2.5-flare",
  "prompt": "A minimalist product poster of a ceramic vase, soft studio light.",
  "size": "auto"
}"""

response = requests.post(url, headers=headers, data=payload)
print(response.status_code)
print(response.text)

const payload = {
  "model": "gpt-image-2.5-flare",
  "prompt": "A minimalist product poster of a ceramic vase, soft studio light.",
  "size": "auto"
};

const response = await fetch("https://newapi.aiftopia.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FOXROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});

console.log(response.status, await response.text());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String payload = """
{
  "model": "gpt-image-2.5-flare",
  "prompt": "A minimalist product poster of a ceramic vase, soft studio light.",
  "size": "auto"
}
""";

        HttpRequest.Builder builder = HttpRequest.newBuilder()
                .uri(URI.create("https://newapi.aiftopia.com/v1/images/generations"))
                .header("Authorization", "Bearer " + System.getenv("FOXROUTER_API_KEY"))
                .header("Content-Type", "application/json")
                .method("POST", HttpRequest.BodyPublishers.ofString(payload))
                .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
                .send(builder.build(), HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}