Input
2
출력
Image link valid for 72 hours
FLUX.1 Kontext API 요금
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
| 모델 | 골드 가격현재 가격 | 플래티넘 가격 | 다이아몬드 가격 | 공식 가격 | 절약률 |
|---|---|---|---|---|---|
flux-kontext-pro | 0.32Credits(~$0.032)/장 | 0.304Credits(~$0.0304)/장 | 0.288Credits(~$0.0288)/장 | 0.4Credits(~$0.04)/장 | 20% |
flux-kontext-max | 0.64Credits(~$0.064)/장 | 0.608Credits(~$0.0608)/장 | 0.576Credits(~$0.0576)/장 | 0.8Credits(~$0.08)/장 | 20% |
* 실제 비용은 최종 출력에 따라 달라집니다.
FLUX.1 Kontext API 예제: 텍스트-이미지와 이미지 편집
POST 요청 한 번으로 flux-kontext-pro를 호출합니다. 생성은 비동기 방식으로, 작업을 제출한 뒤 작업 엔드포인트를 폴링해 이미지 URL을 받습니다.
- 1
FLUX.1 Kontext API 요청 인증
APIMart 키를 APIMART_API_KEY 환경 변수에 저장하고 모든 요청에 Authorization: Bearer <key>를 보냅니다.
- 2
FLUX.1 Kontext 작업 제출
POST /v1/images/generations에 model flux-kontext-pro, 프롬프트, size를 보냅니다. 편집 시 image_urls로 참조 이미지를 최대 4장 추가합니다. example.com 주소는 자리표시자이므로 공개 접근 가능한 내 이미지 URL 또는 Base64로 바꿔 주세요. 작업 ID는 data[0].task_id에 있습니다.
- 3
FLUX.1 Kontext 결과 받기
GET /v1/tasks/{task_id}를 status가 completed가 될 때까지 폴링한 뒤 data.result.images[0].url[0]에서 이미지 URL을 읽습니다. 결과는 72시간 보관되므로 필요한 이미지는 미리 다운로드하세요.
전체 파라미터, 출력 크기, 응답 필드는 FLUX.1 Kontext API 레퍼런스에서 확인하세요.
POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "초록색 안락의자가 있는 아늑한 독서 공간, 따뜻한 램프 불빛, 창밖에 내리는 비",
"size": "4:3",
"output_format": "png"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "flux-kontext-pro",
"prompt": "초록색 안락의자가 있는 아늑한 독서 공간, 따뜻한 램프 불빛, 창밖에 내리는 비",
"size": "4:3",
"output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "재킷을 짙은 빨간 가죽으로 바꾸고 인물의 얼굴, 포즈, 배경은 그대로 유지",
"size": "auto",
"output_format": "png",
"image_urls": [
"https://example.com/portrait.jpg"
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"FLUX.1 Kontext API 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: flux-kontext-pro | flux-kontext-pro 또는 flux-kontext-max. |
prompt | string | 필수 | 기본값: — | 생성할 이미지 또는 참조 이미지에 적용할 편집을 설명합니다. |
image_urls | string[] | 선택 | 기본값: — | 참조 이미지 최대 4장(공개 URL 또는 Base64). 텍스트-이미지에서는 생략합니다. |
size | string | 선택 | 기본값: 1:1 | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21 또는 auto. 출력은 약 1 MP입니다. width·height를 보내면 작업이 실패하고 resolution은 적용되지 않습니다. |
output_format | string | 선택 | 기본값: png | png, jpeg 또는 webp. |
seed | integer | 선택 | 기본값: — | 같은 seed와 입력으로 결과 재현에 도움이 되며, 생략하면 무작위입니다. |
prompt_upsampling | boolean | 선택 | 기본값: false | 생성 전에 모델이 프롬프트를 확장하고 다시 씁니다. |
safety_tolerance | integer | 선택 | 기본값: 2 | 0(가장 엄격)~6. |
nsfw_check | boolean | 선택 | 기본값: false | 제출 전에 omni-moderation-latest로 프롬프트와 입력 이미지를 검사합니다. |
APIMart FLUX API 모델 비교
APIMart API 키 하나로 아래 모든 FLUX 모델을 호출할 수 있습니다. 이미지 모델은 장당, FLUX 3 Video는 영상 초당 과금됩니다.
| 모델 | 추천 용도 | 출력 |
|---|---|---|
| FLUX 3 Image API | 이미지용 FLUX 3 API: 참조 이미지 최대 10장으로 생성·편집, 검색 그라운딩, 최대 4K 출력 | 768sq~4K(약 16 MP) |
| FLUX 3 Image Klein API | 더 저렴한 FLUX 3 이미지. seed, 1–16 steps, PNG 또는 JPEG 출력 | 768sq~4K(약 16 MP) |
| FLUX 3 Video API | 텍스트-비디오, 키프레임 1–10장, 영상 이어 만들기와 초안 생성. 동기화 오디오 포함 | HD 또는 FHD, 5–20초 |
| FLUX.2 API | FLUX.2 Pro·Max·Flex를 한 페이지에서 비교 | 1–4 MP |
| FLUX.2 Pro API | 품질과 비용의 균형이 좋은 프로덕션 이미지. 참조 이미지 최대 8장 | 1–4 MP |
| FLUX.2 Max API | FLUX.2 최고 화질 출력. 참조 이미지 최대 8장 | 1–4 MP |
| FLUX.2 Flex API | steps와 guidance를 조절해 타이포그래피·레이아웃 중심 디자인에 적합 | 1–4 MP |
| FLUX.1 Kontext API현재 페이지 | FLUX.1 Kontext Pro와 Max를 한 페이지에서 비교 | 약 1 MP |
| FLUX.1 Kontext Pro API | 장당 고정 가격의 맥락 인식 편집. 참조 이미지 최대 4장 | 약 1 MP |
| FLUX.1 Kontext Max API | 화질이 더 높고 프롬프트를 더 잘 따르는 Kontext 편집 | 약 1 MP |
