Flux GPT Edit 功能 - AI 图像编辑 - apizt API 中转接口

旧型号文档

flux-kontext-pro 未列入 2026-10-08 核对的 apizt 当前模型目录。本页保留旧协议说明;新接入请从图片模型总览选择当前型号,使用前确认分组可用性。

POST https://api.apizt.com/v1/images/edits 在线调试 →
▼ Authorization

在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token

示例: Authorization: Bearer ********************

概述

给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。 为提供的提示和参数创建完成 官方文档:https://platform.openai.com/docs/api-reference/images/createEdit

请求参数

Header 参数
Accept string
必需
由客户端自动生成 multipart/form-data boundary。
Authorization string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 multipart/form-data
multipart/form-data
可选
image file
必需
要编辑的图片。必须是受支持的图片文件或图片数组。对于 gpt-image-1,每张图片应为小于 25MB 的 png、webp 或 jpg 文件。对于 dall-e-2,您只能提供一张图片,并且该图片应为小于 4MB 的方形 png 文件。 示例: file://C:\Users\Administrator\Desktop\87069cf1-8838-4acf-bb31-e02e6c9a11eb.png
prompt string
必需
所需图像的文本描述。dall-e-2 的最大长度为 1000 个字符,gpt-image-1 的最大长度为 32000 个字符。 示例: 换成红色衣服
mask string
可选
一张附加图片,其完全透明区域(例如,alpha 值为零)指示应编辑 image 位置。如果提供了多张图片,则遮罩将应用于第一张图片。必须是有效的 PNG 文件,小于 4MB,且尺寸与 image 相同。
model string
可选
用于生成图像的模型。仅 gpt-image-1, gpt-image-1-all , flux-kontext-pro , flux-kontext-max。 示例: flux-kontext-max
n string
可选
要生成的图像数量。必须介于 1 到 10 之间。 示例: 1
quality string
可选
生成图像的质量。只有 gpt-image-1 支持 high、medium 和 low 质量。dall-e-2 仅支持 standard 质量。默认为 auto。
response_format string
可选
返回生成图像的格式。必须是 url 或 b64_json 之一。URL 在图像生成后 60 分钟内有效。此参数仅适用于 dall-e-2,因为 gpt-image-1 始终返回 base64 编码的图像,请不要使用这个参数。 示例:
b64_json
可选
aspect_ratio string
可选
生成图像的尺寸。枚举值Possible enum values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 示例: 16:9
background string
可选
允许为生成的图像的背景设置透明度。此参数仅在 gpt-image-1 中受支持。其值必须为 “透明(transparent)”、“不透明(opaque)” 或 “自动(auto)”(默认值)之一。当使用 “自动(auto)” 时,模型将自动为图像确定最佳背景。 示例:
transparent
可选
moderation string
可选
控制由 gpt-image-1 生成的图像的内容审核级别。可以设置为 “low” 以进行限制较少的过滤,也可以设置为 “auto”(默认值)。 示例:
low
可选
请求
示例

请求使用 multipart/form-data。文本字段如下,文件通过 image 上传;不要把本地路径当成文件内容或手动指定没有 boundary 的 Content-Type。

{
  "model": "flux-kontext-pro",
  "prompt": "将背景改为海滩"
}

请求示例代码

请求使用 multipart/form-data。文本字段如下,文件通过 image 上传;不要把本地路径当成文件内容或手动指定没有 boundary 的 Content-Type。

{
  "model": "flux-kontext-pro",
  "prompt": "将背景改为海滩"
}
curl --fail-with-body --request POST 'https://api.apizt.com/v1/images/edits' \
  --header "Authorization: Bearer ${tokenba_API_KEY}" \
  --form 'model=flux-kontext-pro' \
  --form 'prompt=将背景改为海滩' \
  --form '[email protected]'
async function main() {
  const headers = { Authorization: "Bearer " + process.env.tokenba_API_KEY };
  const { readFile } = require("node:fs/promises");
  const body = new FormData();
  body.append("model", "flux-kontext-pro");
  body.append("prompt", "将背景改为海滩");
  body.append("image", new Blob([await readFile("reference.png")], { type: "image/png" }), "reference.png");
  const response = await fetch("https://api.apizt.com/v1/images/edits", { method: "POST", headers, body });
  const result = await response.text();
  if (!response.ok) throw new Error("HTTP " + response.status + ": " + result);
  console.log(result);
}
main().catch(console.error);
import okhttp3.*;
import java.io.File;

class Example {
  public static void main(String[] args) throws Exception {
    OkHttpClient client = new OkHttpClient();
    MultipartBody.Builder form = new MultipartBody.Builder().setType(MultipartBody.FORM);
    form.addFormDataPart("model", "flux-kontext-pro");
    form.addFormDataPart("prompt", "将背景改为海滩");
    form.addFormDataPart("image", "reference.png", RequestBody.create(MediaType.parse("image/png"), new File("reference.png")));
    RequestBody body = form.build();
    Request.Builder request = new Request.Builder().url("https://api.apizt.com/v1/images/edits").header("Authorization", "Bearer " + System.getenv("tokenba_API_KEY"));
    request.method("POST", body);
    try (Response response = client.newCall(request.build()).execute()) {
      if (!response.isSuccessful()) throw new Exception("HTTP " + response.code());
      System.out.println(response.body().string());
    }
  }
}
import Foundation

var request = URLRequest(url: URL(string: "https://api.apizt.com/v1/images/edits")!)
request.httpMethod = "POST"
request.setValue("Bearer " + ProcessInfo.processInfo.environment["tokenba_API_KEY"]!, forHTTPHeaderField: "Authorization")
let boundary = UUID().uuidString
var data = Data()
func append(_ value: String) { data.append(value.data(using: .utf8)!) }
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nflux-kontext-pro\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n将背景改为海滩\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"image\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n")
data.append(try Data(contentsOf: URL(fileURLWithPath: "reference.png")))
append("\r\n")
append("--\(boundary)--\r\n")
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
request.httpBody = data
let (data, response) = try await URLSession.shared.data(for: request)
print((response as? HTTPURLResponse)?.statusCode ?? 0)
print(String(data: data, encoding: .utf8) ?? "")
package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "mime/multipart"
)

func main() {
  var buffer bytes.Buffer
  writer := multipart.NewWriter(&buffer)
  if err := writer.WriteField("model", "flux-kontext-pro"); err != nil { panic(err) }
  if err := writer.WriteField("prompt", "将背景改为海滩"); err != nil { panic(err) }
  file0, err := os.Open("reference.png")
  if err != nil { panic(err) }; defer file0.Close()
  part0, err := writer.CreateFormFile("image", "reference.png")
  if err != nil { panic(err) }
  if _, err = io.Copy(part0, file0); err != nil { panic(err) }
  if err := writer.Close(); err != nil { panic(err) }
  req, err := http.NewRequest("POST", "https://api.apizt.com/v1/images/edits", &buffer)
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer " + os.Getenv("tokenba_API_KEY"))
  req.Header.Set("Content-Type", writer.FormDataContentType())
  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }; defer resp.Body.Close()
  data, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.Status, string(data))
}
<?php
$headers = ["Authorization: Bearer " . getenv("tokenba_API_KEY")];
$body = [
  'model' => 'flux-kontext-pro',
  'prompt' => '将背景改为海滩',
  'image' => new CURLFile('reference.png'),
];
$curl = curl_init('https://api.apizt.com/v1/images/edits');
curl_setopt_array($curl, [CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $body]);
$result = curl_exec($curl);
if ($result === false) throw new Exception(curl_error($curl));
echo $result;
curl_close($curl);
import os
import requests
from contextlib import ExitStack

headers = {"Authorization": "Bearer " + os.environ["tokenba_API_KEY"]}
data = {'model': 'flux-kontext-pro', 'prompt': '将背景改为海滩'}
with ExitStack() as stack:
    files = {
        'image': ('reference.png', stack.enter_context(open('reference.png', "rb")), 'image/png'),
    }
    response = requests.request('POST', 'https://api.apizt.com/v1/images/edits', headers=headers, data=data, files=files, timeout=120)
    response.raise_for_status()
    print(response.text)
POST /v1/images/edits HTTP/1.1
Host: api.apizt.com
Authorization: Bearer YOUR_tokenba_API_KEY
Content-Type: multipart/form-data; boundary=tokenba-demo

--tokenba-demo
Content-Disposition: form-data; name="model"

flux-kontext-pro
--tokenba-demo
Content-Disposition: form-data; name="prompt"

将背景改为海滩
--tokenba-demo
Content-Disposition: form-data; name="image"; filename="reference.png"
Content-Type: image/png

< ./reference.png
--tokenba-demo--
#include <curl/curl.h>
#include <stdlib.h>
#include <stdio.h>

int main(void) {
  curl_global_init(CURL_GLOBAL_DEFAULT);
  CURL *curl = curl_easy_init();
  if (!curl) return 1;
  char auth[4096];
  snprintf(auth, sizeof(auth), "Authorization: Bearer %s", getenv("tokenba_API_KEY"));
  struct curl_slist *headers = curl_slist_append(NULL, auth);
  curl_mime *mime = curl_mime_init(curl);
  curl_mimepart *part;
  part = curl_mime_addpart(mime); curl_mime_name(part, "model"); curl_mime_data(part, "flux-kontext-pro", CURL_ZERO_TERMINATED);
  part = curl_mime_addpart(mime); curl_mime_name(part, "prompt"); curl_mime_data(part, "将背景改为海滩", CURL_ZERO_TERMINATED);
  part = curl_mime_addpart(mime); curl_mime_name(part, "image"); curl_mime_filedata(part, "reference.png");
  curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);
  curl_easy_setopt(curl, CURLOPT_URL, "https://api.apizt.com/v1/images/edits");
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  CURLcode result = curl_easy_perform(curl);
  curl_mime_free(mime);
  curl_slist_free_all(headers); curl_easy_cleanup(curl); curl_global_cleanup();
  return result == CURLE_OK ? 0 : 1;
}
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.apizt.com/v1/images/edits");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("tokenba_API_KEY"));
using var form = new MultipartFormDataContent();
form.Add(new StringContent("flux-kontext-pro"), "model");
form.Add(new StringContent("将背景改为海滩"), "prompt");
form.Add(new StreamContent(File.OpenRead("reference.png")), "image", "reference.png");
request.Content = form;
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
#import <Foundation/Foundation.h>

int main(void) {
@autoreleasepool {
dispatch_semaphore_t done = dispatch_semaphore_create(0);
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.apizt.com/v1/images/edits"]];
request.HTTPMethod = @"POST";
NSDictionary *env = [[NSProcessInfo processInfo] environment];
[request setValue:[@"Bearer " stringByAppendingString:env[@"tokenba_API_KEY"]] forHTTPHeaderField:@"Authorization"];
NSString *boundary = [[NSUUID UUID] UUIDString];
NSMutableData *data = [NSMutableData data];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nflux-kontext-pro\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n将背景改为海滩\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"image\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[NSData dataWithContentsOfFile:@"reference.png"]];
[data appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@--\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[request setValue:[@"multipart/form-data; boundary=" stringByAppendingString:boundary] forHTTPHeaderField:@"Content-Type"];
request.HTTPBody = data;
[[[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) { NSLog(@"%@", error); dispatch_semaphore_signal(done); return; }
  NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
  dispatch_semaphore_signal(done);
}] resume];
dispatch_semaphore_wait(done, DISPATCH_TIME_FOREVER);
}
return 0;
}
require "net/http"
require "json"

uri = URI("https://api.apizt.com/v1/images/edits")
request = Net::HTTPGenericRequest.new("POST", true, true, uri.request_uri)
request["Authorization"] = "Bearer " + ENV.fetch("tokenba_API_KEY")
files = []
begin
  fields = [["model", "flux-kontext-pro"], ["prompt", "将背景改为海滩"]]
  file = File.open("reference.png", "rb"); files << file; fields << ["image", file]
  request.set_form(fields, "multipart/form-data")
  puts Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request).body }
ensure
  files.each(&:close)
end
open Lwt.Infix

let () =
  let headers = Cohttp.Header.init_with "Authorization" ("Bearer " ^ Sys.getenv "tokenba_API_KEY") in
  let data = "--tokenba-demo\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nflux-kontext-pro\r\n" ^
    "--tokenba-demo\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n将背景改为海滩\r\n" ^
    "--tokenba-demo\r\nContent-Disposition: form-data; name=\"image\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n" ^
    (let f = open_in_bin "reference.png" in let data = really_input_string f (in_channel_length f) in close_in f; data) ^
    "\r\n" ^
    "--tokenba-demo--\r\n" in
  let headers = Cohttp.Header.add headers "Content-Type" "multipart/form-data; boundary=tokenba-demo" in
  Lwt_main.run (
    Cohttp_lwt_unix.Client.call ~headers ~body:(Cohttp_lwt.Body.of_string data) `POST (Uri.of_string "https://api.apizt.com/v1/images/edits") >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= print_endline
  )
import "dart:io";
import "package:http/http.dart" as http;

Future<void> main() async {
  final headers = {"Authorization": "Bearer ${Platform.environment['tokenba_API_KEY']}"};
  final request = http.MultipartRequest("POST", Uri.parse("https://api.apizt.com/v1/images/edits"));
  request.headers.addAll(headers);
  request.fields["model"] = "flux-kontext-pro";
  request.fields["prompt"] = "将背景改为海滩";
  request.files.add(await http.MultipartFile.fromPath("image", "reference.png"));
  final response = await request.send();
  print(response.statusCode);
  print(await response.stream.bytesToString());
}
library(httr)

headers <- c(Authorization = paste("Bearer", Sys.getenv("tokenba_API_KEY")))
body <- list(
  model = "flux-kontext-pro",
  prompt = "将背景改为海滩",
  image = upload_file("reference.png")
)
response <- VERB("POST", "https://api.apizt.com/v1/images/edits", add_headers(.headers = headers), body = body, encode = "multipart")
stop_for_status(response)
cat(content(response, "text", encoding = "UTF-8"))

返回响应

以下为协议结构示意,ID、时间和结果内容为演示值;以实际网关返回为准。

application/json
createdinteger必需
生成时间,Unix 秒级时间戳。
dataarray [object]必需
生成图像结果列表。
data[].b64_jsonstring可选
Base64 图像数据;按模型与返回模式提供。
data[].urlstring可选
图像地址;按模型与返回模式提供,不保证永久有效。
usageobject可选
用量信息,是否返回及明细由模型决定。
{
  "created": 1760000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

代码示例先设置 tokenba_API_KEY 为你的令牌;示例中的文件名和资源 ID 请替换为自己的值。JavaScript 使用 Node.js 20+,Python 先安装 requests;Java 使用 OkHttp,C 使用 libcurl,OCaml 使用 cohttp-lwt-unix,Dart 使用 http,R 使用 httr。HTTP 文件行采用支持文件引用的 HTTP 客户端语法。

当前模型与版本

依据 apizt 价格页,同步于 。以下型号按目录声明的协议与本页用途筛选;不代表所有参数和功能通用。切换前请核对型号说明、令牌分组与参数差异。Gemini 原生接口需同时替换 URL 中的模型 ID。

模型 ID能力标签支持分组
gpt-image-2.5-sunburst绘画,dall-e-3格式
分组(4)

Azure-Gpt-4、Azure-Gpt-5、Openai-Gpt-1、Openai-Gpt-2

gpt-image-2.5-flare绘画,dall-e-3格式
分组(4)

Azure-Gpt-4、Azure-Gpt-5、Openai-Gpt-1、Openai-Gpt-2

gpt-image-2.5-sunburst-c绘画,dall-e-3格式
分组(3)

Gpt-Image-1、Gpt-Image-2、Gpt-Image-3

gpt-image-2.5-flare-c绘画,dall-e-3格式
分组(3)

Gpt-Image-1、Gpt-Image-2、Gpt-Image-3

gpt-image-2绘画,dall-e-3格式
分组(8)

Azure-Gpt-2、Azure-Gpt-3、Azure-Gpt-4、Azure-Gpt-5、Codex-Gpt-2、Codex-Gpt-3、Openai-Gpt-1、Openai-Gpt-2

gpt-image-2-c绘画
分组(3)

Gpt-Image-1、Gpt-Image-2、Gpt-Image-3

gpt-image-1.5dall-e-3格式,绘画
分组(7)

Azure-Gpt-1、Azure-Gpt-2、Azure-Gpt-3、Azure-Gpt-4、Azure-Gpt-5、Openai-Gpt-1、Openai-Gpt-2

gpt-image-1绘画,dall-e-3格式
分组(7)

Azure-Gpt-1、Azure-Gpt-2、Azure-Gpt-3、Azure-Gpt-4、Azure-Gpt-5、Openai-Gpt-1、Openai-Gpt-2

共列入 11 个候选型号。查看完整模型、版本与接口目录。