> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireiter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX 3 Klein 이미지 생성

> - 비동기 처리 모드, 후속 조회를 위한 작업 ID 반환
- Black Forest Labs가 2026년 10월 발표한 FLUX 3 Image 경량 오픈소스 가중치 버전(5.6B 파라미터), 빠른 이미지 편집에 특화되어 있으며 텍스트-투-이미지도 지원
- 텍스트-투-이미지 및 이미지-투-이미지 지원, image_url 전달 시 자동으로 이미지-투-이미지로 전환
- 최대 3장의 참조 이미지 지원, 첫 번째 이미지는 편집할 대상이며 나머지는 피사체, 상품 및 스타일 참조 제공
- 생성 전 프롬프트 자동 확장
- 7가지 주요 이미지 비율 지원
- 1K / 2K 해상도 옵션 지원, 1회 최대 4장 생성
- 제출된 prompt는 플랫폼 민감어 / 안전 검토를 거치며, 위반 콘텐츠는 즉시 거부됨


## Authorizations

**Authorization** `string` *required*

모든 API는 Bearer Token을 사용하여 인증해야 합니다.

API Key 받기:

[API Key 관리 페이지](https://aireiter.com/keys)에 접속하여 API Key를 받으세요.

사용 시 요청 헤더에 추가:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

모델 이름입니다.

고정값: `"flux_3_klein"`

**params** `object` *required*

모델 파라미터 객체입니다.

**params 객체 속성**

**prompt** `string` *required*

이미지 생성 또는 편집 명령어이며, 최대 4000자까지 지원합니다.

* 중국어와 영어를 지원하며, 피사체, 배경, 구도, 조명, 재질 및 유지해야 할 참조 이미지의 특징을 명확히 설명하는 것을 권장합니다
* 이미지 투 이미지(Image-to-Image) 작업 시, 프롬프트에 유지할 내용과 수정할 내용을 명확히 명시해야 합니다
* 모델이 생성 전에 프롬프트를 자동으로 확장하므로, 수식어를 나열할 필요 없이 의도만 명확하게 작성하면 됩니다
* 제출 전 플랫폼 민감어 / 안전 검사를 거치며, 위반 내용이 포함된 경우 오류가 직접 반환됩니다

**image\_url** `string[]`

참조 이미지 배열입니다. 전달 시 자동으로 이미지 투 이미지 모드가 사용되며, 전달하지 않으면 텍스트 투 이미지 모드가 사용됩니다.

* 최대 3장의 참조 이미지를 지원하며, 첫 번째 이미지는 편집 대상 이미지이고 나머지는 피사체, 상품 또는 스타일 참조용으로 사용됩니다
* 이미지당 최대 10MB
* jpeg, png, webp 지원
* 다음 두 가지 형식을 지원합니다:
  1. 공개적으로 접근 가능한 URL
  2. 완전한 Base64 Data URI(예: `data:image/jpeg;base64,/9j/4AAQ...`)

> [!WARNING]
>
> URL은 공용 네트워크에서 직접 접근할 수 있어야 하며, 로그인, 쿠키 또는 임시 페이지 인증을 요구해서는 안 됩니다.

**aspect\_ratio** `string` (default: 1:1)

이미지 가로세로 비율입니다.

지원되는 값은 다음과 같습니다:

* `1:1` - 정사각형(기본값)
* `5:4` / `4:5` - 약간 넓은 가로형 / 세로형
* `4:3` / `3:4` - 표준 가로형 / 세로형
* `16:9` / `9:16` - 와이드 가로형 / 세로형

> [!WARNING]
>
> `aspect_ratio`는 모델의 목표 비율 단계를 나타내며, 고정된 픽셀 크기를 보장하지 않고 해당 비율에 가까운 모델 원시 크기를 반환합니다.

**resolution** `string` (default: 1K)

이미지 해상도 단계입니다.

* `1K` - 기본 해상도(기본값)
* `2K` - 고해상도

**output\_n** `string` (default: 1)

생성할 이미지 수입니다.

지원되는 값은 다음과 같습니다:

* `"1"` - 1장 생성(기본값)
* `"2"` - 2장 생성
* `"4"` - 4장 생성

**out\_task\_id** `string` *required*

호출자가 정의한 사용자 지정 작업 ID로, 멱등성 제출 및 결과 조회에 사용됩니다.

* 길이는 1\~64자
* 영문자, 숫자, 밑줄(\_), 하이픈(-)만 허용
* 동일한 API Key 내에서 중복 사용할 수 없음

## Response

**out\_task\_id** `string`

호출자 작업 ID로, 결과 조회에 사용할 수 있습니다.

**status** `string`

초기 상태로, `"pending"`으로 고정됩니다.

**created\_at** `string`

생성 시간, ISO 8601 형식입니다.

## 查询结果

제출 성공 후, 동일한 `out_task_id`를 사용하여 호출합니다:

```bash theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "flux_3_klein_task_001"
  }'
```

작업 상태에는 `pending`, `processing`, `completed` 및 `failed`가 포함됩니다. 작업이 완료되면 결과 이미지는 `data.output`에 위치하며, 여러 장을 생성한 경우 여러 이미지 URL로 구성된 배열이 됩니다.

```bash cURL(텍스트 투 이미지) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux_3_klein",
    "params": {
      "prompt": "미래적인 전기 스포츠카가 현대적인 유리 건물 앞에 주차되어 있는 모습, 블루 아워, 젖은 노면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_n": "2"
    },
    "out_task_id": "flux_3_klein_task_001"
  }'
```

```bash cURL(이미지 투 이미지) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux_3_klein",
    "params": {
      "prompt": "첫 번째 참조 이미지 속 제품 용기를 고급스러운 야간 광고 스타일로 변경, 병의 형태, 비율, 노즐, 투명 유리 구조 및 라벨 텍스트 유지, 제품 외관은 두 번째 이미지 참조, 배경과 조명은 세 번째 이미지 참조",
      "image_url": [
        "https://example.com/product-original.png",
        "https://example.com/product-texture.png",
        "https://example.com/style-reference.png"
      ],
      "aspect_ratio": "16:9",
      "resolution": "1K",
      "output_n": "2"
    },
    "out_task_id": "flux_3_klein_image_task_001"
  }'
```

```python Python theme={null}
import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "flux_3_klein",
    "params": {
        "prompt": "시네마틱한 제품 광고 사진, 검은 석대 위에 놓인 유리 향수병, 사실적인 반사와 자연스러운 그림자",
        "aspect_ratio": "16:9",
        "resolution": "1K",
        "output_n": "1"
    },
    "out_task_id": "flux_3_klein_python_001"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```javascript JavaScript theme={null}
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_3_klein",
    params: {
      prompt: "시네마틱한 제품 광고 사진, 검은 석대 위에 놓인 유리 향수병, 사실적인 반사와 자연스러운 그림자",
      aspect_ratio: "16:9",
      resolution: "1K",
      output_n: "1"
    },
    out_task_id: "flux_3_klein_javascript_001"
  })
});

console.log(await response.json());
```

```go Go theme={null}
package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := []byte(`{
      "model":"flux_3_klein",
      "params":{
        "prompt":"시네마틱한 제품 광고 사진, 검은 석대 위에 놓인 유리 향수병, 사실적인 반사와 자연스러운 그림자",
        "aspect_ratio":"16:9",
        "resolution":"1K"
      },
      "out_task_id":"flux_3_klein_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))
}
```

```java Java theme={null}
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_3_klein",
          "params": {
            "prompt": "시네마틱한 제품 광고 사진, 검은 석대 위에 놓인 유리 향수병, 사실적인 반사와 자연스러운 그림자",
            "aspect_ratio": "16:9",
            "resolution": "1K"
          },
          "out_task_id": "flux_3_klein_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 PHP theme={null}
<?php

$payload = [
    "model" => "flux_3_klein",
    "params" => [
        "prompt" => "시네마틱한 제품 광고 사진, 검은 석대 위에 놓인 유리 향수병, 사실적인 반사와 자연스러운 그림자",
        "aspect_ratio" => "16:9",
        "resolution" => "1K"
    ],
    "out_task_id" => "flux_3_klein_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);
?>
```

```ruby Ruby theme={null}
require 'net/http'
require 'json'
require 'uri'

url = URI("https://aireiter.com/api/openapi/submit")

payload = {
  model: "flux_3_klein",
  params: {
    prompt: "현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
    aspect_ratio: "16:9",
    resolution: "2K"
  },
  out_task_id: "flux_3_klein_task_001"
}

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body
```

```swift Swift theme={null}
import Foundation

let url = URL(string: "https://aireiter.com/api/openapi/submit")!

let payload: [String: Any] = [
    "model": "flux_3_klein",
    "params": [
        "prompt": "현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
        "aspect_ratio": "16:9",
        "resolution": "2K"
    ],
    "out_task_id": "flux_3_klein_task_001"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("Error: \(error)")
        return
    }

    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()
```

```csharp C# theme={null}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://aireiter.com/api/openapi/submit";

        var payload = @"
              {
                  ""model"": ""flux_3_klein"",
                  ""params"": {
                      ""prompt"": ""현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음"",
                      ""aspect_ratio"": ""16:9"",
                      ""resolution"": ""2K""
                  },
                  ""out_task_id"": ""flux_3_klein_task_001""
              }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}
```

```c C theme={null}
#include <stdio.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl;
    CURLcode res;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        const char *url = "https://aireiter.com/api/openapi/submit";
        const char *payload = "{\"model\":\"flux_3_klein\",\"params\":{\"prompt\":\"현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음\",\"aspect_ratio\":\"16:9\",\"resolution\":\"2K\"},\"out_task_id\":\"flux_3_klein_task_001\"}";

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer <token>");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        res = curl_easy_perform(curl);

        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() failed: %s\n",
                    curl_easy_strerror(res));
        }

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}
```

```objectivec Objective-C theme={null}
#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NSURL *url = [NSURL URLWithString:@"https://aireiter.com/api/openapi/submit"];

        NSDictionary *payload = @{
            @"model": @"flux_3_klein",
            @"params": @{
                @"prompt": @"현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
                @"aspect_ratio": @"16:9",
                @"resolution": @"2K"
            },
            @"out_task_id": @"flux_3_klein_task_001"
        };

        NSError *error;
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:payload
                                                          options:0
                                                            error:&error];

        NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
        [request setHTTPMethod:@"POST"];
        [request setValue:@"Bearer <token>" forHTTPHeaderField:@"Authorization"];
        [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
        [request setHTTPBody:jsonData];

        NSURLSessionDataTask *task = [[NSURLSession sharedSession]
            dataTaskWithRequest:request
            completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                if (error) {
                    NSLog(@"Error: %@", error);
                    return;
                }
                NSString *result = [[NSString alloc] initWithData:data
                                                        encoding:NSUTF8StringEncoding];
                NSLog(@"%@", result);
            }];

        [task resume];
        [[NSRunLoop mainRunLoop] run];
    }
    return 0;
}
```

```ocaml OCaml theme={null}
(* Requires cohttp and yojson libraries *)
open Lwt
open Cohttp
open Cohttp_lwt_unix

let url = "https://aireiter.com/api/openapi/submit"

let payload = {|{
  "model": "flux_3_klein",
  "params": {
    "prompt": "현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
    "aspect_ratio": "16:9",
    "resolution": "2K"
  },
  "out_task_id": "flux_3_klein_task_001"
}|}

let () =
  let headers = Header.init ()
    |> fun h -> Header.add h "Authorization" "Bearer <token>"
    |> fun h -> Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string payload in

  let response = Client.post ~headers ~body (Uri.of_string url) >>= fun (resp, body) ->
    body |> Cohttp_lwt.Body.to_string >|= fun body_str ->
    print_endline body_str
  in
  Lwt_main.run response
```

```dart Dart theme={null}
import 'dart:convert';
import 'package:http/http.dart' as http;

void main() async {
  final url = Uri.parse('https://aireiter.com/api/openapi/submit');

  final payload = {
        "model": "flux_3_klein",
        "params": {
            "prompt": "현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
            "aspect_ratio": "16:9",
            "resolution": "2K"
        },
        "out_task_id": "flux_3_klein_task_001"
    };

  final response = await http.post(
    url,
    headers: {
      'Authorization': 'Bearer <token>',
      'Content-Type': 'application/json'
    },
    body: jsonEncode(payload),
  );

  print(response.body);
}
```

```r R theme={null}
library(httr)
library(jsonlite)

url <- "https://aireiter.com/api/openapi/submit"

payload <- list(
  model = "flux_3_klein",
  params = list(
    prompt = "현대적인 유리 건물 앞에 주차된 미래지향적인 전기 스포츠카, 블루 아워, 젖은 지면에 반사되는 건물 조명, 상업용 자동차 사진, 사실적인 질감과 자연스러운 그림자, 텍스트 없음, 워터마크 없음",
    aspect_ratio = "16:9",
    resolution = "2K"
  ),
  out_task_id = "flux_3_klein_task_001"
)

response <- POST(
  url,
  add_headers(
    Authorization = "Bearer <token>",
    `Content-Type` = "application/json"
  ),
  body = toJSON(payload, auto_unbox = TRUE),
  encode = "raw"
)

cat(content(response, "text"))
```

```json 200 theme={null}
{
  "statusCode": 200,
  "message": "",
  "data": {
    "task_id": "",
    "status": "pending",
    "created_at": "2026-07-22T10:37:44.800Z",
    "out_task_id": "flux_3_klein_task_001"
  },
  "ok": true
}
```

```json 400 theme={null}
{
  "statusCode": 400,
  "message": "Invalid aspect_ratio: \"widescreen\". Allowed: [1:1, 5:4, 4:5, 4:3, 3:4, 16:9, 9:16]",
  "ok": false
}
```

```json 401 theme={null}
{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인해 주세요"
  }
}
```

```json 500 theme={null}
{
  "error": {
    "code": 500,
    "message": "서버 내부 오류가 발생했습니다. 잠시 후 다시 시도해 주세요"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.