curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "A futuristic electric sports car parked in front of a modern glass building, blue hour, wet ground reflecting building lights, commercial automotive photography, realistic materials and natural shadows, no text, no watermark",
"aspect_ratio": "16:9",
"resolution": "2K"
},
"out_task_id": "flux_2_pro_task_001"
}'
curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "Transform the reference product image into a high-end nighttime advertising style, keeping bottle shape, proportions, spray head, transparent glass structure, and label text, using a dark gray background with cool contour lighting, only keeping one product",
"image_url": [
"https://example.com/product-reference.png"
],
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_image_task_001"
}'
import requests
url = "https://aireiter.com/api/openapi/submit"
payload = {
"model": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_python_001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://aireiter.com/api/openapi/submit", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "flux_2_pro",
params: {
prompt: "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
aspect_ratio: "16:9",
resolution: "1K"
},
out_task_id: "flux_2_pro_javascript_001"
})
});
console.log(await response.json());
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{
"model":"flux_2_pro",
"params":{
"prompt":"Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio":"16:9",
"resolution":"1K"
},
"out_task_id":"flux_2_pro_go_001"
}`)
req, _ := http.NewRequest(
http.MethodPost,
"https://aireiter.com/api/openapi/submit",
bytes.NewBuffer(payload),
)
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
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": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_java_001"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://aireiter.com/api/openapi/submit"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(payload))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request,
HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}
<?php
$payload = [
"model" => "flux_2_pro",
"params" => [
"prompt" => "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio" => "16:9",
"resolution" => "1K"
],
"out_task_id" => "flux_2_pro_php_001"
];
$ch = curl_init("https://aireiter.com/api/openapi/submit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json"
]);
echo curl_exec($ch);
curl_close($ch);
?>
{
"statusCode": 200,
"message": "",
"data": {
"task_id": "",
"status": "pending",
"created_at": "2026-07-22T10:37:44.800Z",
"out_task_id": "flux_2_pro_task_001",
"estimated_credits": 5
},
"ok": true
}
{
"statusCode": 400,
"message": "Invalid aspect_ratio: \"widescreen\". Allowed: [1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3]",
"ok": false
}
{
"error": {
"code": 401,
"message": "Authentication failed, please check your API key"
}
}
{
"error": {
"code": 433,
"message": "Insufficient account balance, please recharge and try again"
}
}
{
"error": {
"code": 500,
"message": "Internal server error, please try again later"
}
}
FLUX.2 Pro
FLUX.2 Pro Image Generation
- Asynchronous processing mode, returns a task ID for subsequent query
- Supports text-to-image and image-to-image; automatically switches to image-to-image when image_url is provided
- Supports up to 8 reference images for consistency in subject, product, style, and composition
- Supports 7 common image aspect ratios
- Supports 1K / 2K resolution levels
- Submitted prompts undergo platform sensitive word / safety review; violating content will be directly rejected
POST
/
api
/
openapi
/
submit
curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "A futuristic electric sports car parked in front of a modern glass building, blue hour, wet ground reflecting building lights, commercial automotive photography, realistic materials and natural shadows, no text, no watermark",
"aspect_ratio": "16:9",
"resolution": "2K"
},
"out_task_id": "flux_2_pro_task_001"
}'
curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "Transform the reference product image into a high-end nighttime advertising style, keeping bottle shape, proportions, spray head, transparent glass structure, and label text, using a dark gray background with cool contour lighting, only keeping one product",
"image_url": [
"https://example.com/product-reference.png"
],
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_image_task_001"
}'
import requests
url = "https://aireiter.com/api/openapi/submit"
payload = {
"model": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_python_001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://aireiter.com/api/openapi/submit", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "flux_2_pro",
params: {
prompt: "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
aspect_ratio: "16:9",
resolution: "1K"
},
out_task_id: "flux_2_pro_javascript_001"
})
});
console.log(await response.json());
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{
"model":"flux_2_pro",
"params":{
"prompt":"Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio":"16:9",
"resolution":"1K"
},
"out_task_id":"flux_2_pro_go_001"
}`)
req, _ := http.NewRequest(
http.MethodPost,
"https://aireiter.com/api/openapi/submit",
bytes.NewBuffer(payload),
)
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
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": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_java_001"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://aireiter.com/api/openapi/submit"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(payload))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request,
HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}
<?php
$payload = [
"model" => "flux_2_pro",
"params" => [
"prompt" => "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio" => "16:9",
"resolution" => "1K"
],
"out_task_id" => "flux_2_pro_php_001"
];
$ch = curl_init("https://aireiter.com/api/openapi/submit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json"
]);
echo curl_exec($ch);
curl_close($ch);
?>
{
"statusCode": 200,
"message": "",
"data": {
"task_id": "",
"status": "pending",
"created_at": "2026-07-22T10:37:44.800Z",
"out_task_id": "flux_2_pro_task_001",
"estimated_credits": 5
},
"ok": true
}
{
"statusCode": 400,
"message": "Invalid aspect_ratio: \"widescreen\". Allowed: [1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3]",
"ok": false
}
{
"error": {
"code": 401,
"message": "Authentication failed, please check your API key"
}
}
{
"error": {
"code": 433,
"message": "Insufficient account balance, please recharge and try again"
}
}
{
"error": {
"code": 500,
"message": "Internal server error, please try again later"
}
}
Authorizations
string
required
All endpoints require authentication using a Bearer Token.Get the API Key:Visit the API Key management page to get your API Key.Add the following in the request header:
Authorization: Bearer YOUR_API_KEY
Body
string
required
Model name.Fixed value:
"flux_2_pro"object
required
Model parameter object.
Show params object properties
Show params object properties
string
required
Image generation or editing instruction, up to 5000 characters.
- Supports Chinese and English; it is recommended to clearly describe the subject, scene, composition, lighting, material, and reference image features to be retained
- When performing image-to-image, the prompt should clearly specify content to be retained and modified
- Submissions will undergo platform sensitivity/safety review; hitting violation content will directly return an error
string[]
Array of reference images. Providing this automatically enables image-to-image mode; if omitted, text-to-image mode is used.
- Up to 8 reference images
- Maximum 10 MB per image
- Supports jpeg, png, webp
- Supports the following two formats:
- Publicly accessible URLs
- Complete Base64 Data URIs, e.g.,
data:image/jpeg;base64,/9j/4AAQ...
URLs must be publicly accessible without requiring login, cookies, or temporary page authorization.
string
default:"1:1"
Image aspect ratio.Supported values:
1:1- Square (default)4:3/3:4- Standard landscape / portrait16:9/9:16- Widescreen landscape / portrait3:2/2:3- Classic landscape / portrait
aspect_ratio represents the target ratio step of the model and does not guarantee fixed pixel dimensions. Different generation modes may return native model sizes close to the ratio. For example, tested 1K image-to-image 16:9 returns 1344×768, 2K text-to-image 16:9 returns 1920×1088.string
default:"1K"
Image resolution tier.
1K- Basic resolution (default), approximately consumes 5 points per image2K- High resolution, approximately consumes 7 points per image
string
required
Caller-defined task ID used for idempotent submission and querying results.
- Length is 1-64 characters
- Only letters, numbers, underscores, and hyphens are allowed
- Cannot be reused under the same API Key
Billing
| resolution | Estimated Credits Used | Number of Generations |
|---|---|---|
1K | 5 | 1 image |
2K | 7 | 1 image |
estimated_credits in the response is the estimated credits used. After the task is completed, the actual credits used can be checked in the credits_used field of the query interface response. If the task generation fails, the system will automatically refund the pre-deducted credits for this task.
Response
string
Caller task ID, which can be used to query the result.
string
Initial status, fixed as
"pending".number
Estimated credit consumption.
string
Creation time, in ISO 8601 format.
Query Results
After submitting successfully, call with the sameout_task_id:
curl --request POST \
--url https://aireiter.com/api/openapi/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"out_task_id": "flux_2_pro_task_001"
}'
pending, processing, completed, and failed. After the task is completed, the result images are located in data.output, and the actual credits consumed are in data.credits_used.
curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "A futuristic electric sports car parked in front of a modern glass building, blue hour, wet ground reflecting building lights, commercial automotive photography, realistic materials and natural shadows, no text, no watermark",
"aspect_ratio": "16:9",
"resolution": "2K"
},
"out_task_id": "flux_2_pro_task_001"
}'
curl --request POST \
--url https://aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux_2_pro",
"params": {
"prompt": "Transform the reference product image into a high-end nighttime advertising style, keeping bottle shape, proportions, spray head, transparent glass structure, and label text, using a dark gray background with cool contour lighting, only keeping one product",
"image_url": [
"https://example.com/product-reference.png"
],
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_image_task_001"
}'
import requests
url = "https://aireiter.com/api/openapi/submit"
payload = {
"model": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_python_001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://aireiter.com/api/openapi/submit", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "flux_2_pro",
params: {
prompt: "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
aspect_ratio: "16:9",
resolution: "1K"
},
out_task_id: "flux_2_pro_javascript_001"
})
});
console.log(await response.json());
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{
"model":"flux_2_pro",
"params":{
"prompt":"Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio":"16:9",
"resolution":"1K"
},
"out_task_id":"flux_2_pro_go_001"
}`)
req, _ := http.NewRequest(
http.MethodPost,
"https://aireiter.com/api/openapi/submit",
bytes.NewBuffer(payload),
)
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
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": "flux_2_pro",
"params": {
"prompt": "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio": "16:9",
"resolution": "1K"
},
"out_task_id": "flux_2_pro_java_001"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://aireiter.com/api/openapi/submit"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(payload))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request,
HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}
<?php
$payload = [
"model" => "flux_2_pro",
"params" => [
"prompt" => "Cinematic product advertising photography, glass perfume bottle placed on a black stone pedestal, realistic reflections and natural shadows",
"aspect_ratio" => "16:9",
"resolution" => "1K"
],
"out_task_id" => "flux_2_pro_php_001"
];
$ch = curl_init("https://aireiter.com/api/openapi/submit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <token>",
"Content-Type: application/json"
]);
echo curl_exec($ch);
curl_close($ch);
?>
{
"statusCode": 200,
"message": "",
"data": {
"task_id": "",
"status": "pending",
"created_at": "2026-07-22T10:37:44.800Z",
"out_task_id": "flux_2_pro_task_001",
"estimated_credits": 5
},
"ok": true
}
{
"statusCode": 400,
"message": "Invalid aspect_ratio: \"widescreen\". Allowed: [1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3]",
"ok": false
}
{
"error": {
"code": 401,
"message": "Authentication failed, please check your API key"
}
}
{
"error": {
"code": 433,
"message": "Insufficient account balance, please recharge and try again"
}
}
{
"error": {
"code": 500,
"message": "Internal server error, please try again later"
}
}
⌘I