하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-max",
"prompt": "이 제품 사진을 편집해 주세요: 제품을 정확히 동일하게 유지하면서 배경을 열대 해변으로 변경해 주세요."
}'import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-max",
prompt: "이 제품 사진을 편집해 주세요: 제품을 정확히 동일하게 유지하면서 배경을 열대 해변으로 변경해 주세요.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\FluxKontext\FluxKontextClient;
$client = new FluxKontextClient();
$result = $client->textToImage->run([
'model' => 'flux-kontext-max',
'prompt' => '이 제품 사진을 편집해 주세요: 제품을 정확히 동일하게 유지하면서 배경을 열대 해변으로 변경해 주세요.',
]);require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-max",
prompt: "이 제품 사진을 편집해 주세요: 제품을 정확히 동일하게 유지하면서 배경을 열대 해변으로 변경해 주세요."
)npx skills add runapi-ai/flux-kontext -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor개요
Flux Kontext 소개
Flux Kontext는 스타일, 캐릭터 정체성, 장면 구도를 보존하면서 대상 편집을 적용하는 Black Forest Labs의 인컨텍스트 이미지 편집 모델입니다. 스타일 전환과 시각적 일관성 유지에 탁월합니다.
제공사
Black Forest Labs
모달리티
Image
변형
요금
Flux Kontext 요금
| endpoint | 해상도 | 길이 | 가격 | |
|---|---|---|---|---|
| text_to_image | — | — | $0.17 / image |
flux-kontext-max 기준 요금입니다. 다른 변형은 각자의 endpoint 요금이 적용됩니다.
에이전트 통합
에이전트에서 Flux Kontext 실행
작동 방식
Flux Kontext 시작하기
-
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 Flux Kontext을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
Flux Kontext FAQ
컨텍스트 편집이란 무엇인가요?
Flux Kontext는 건드리지 않은 영역의 조명, 원근감, 스타일을 보존하면서 이미지의 특정 영역을 편집합니다.
Pro와 Max의 차이는 무엇인가요?
Pro는 대부분의 편집 작업에 적합한 표준 티어입니다. Max는 더 높은 충실도를 제공하며 복잡한 다중 요소 편집에 적합합니다.
어떤 입력 형식이 지원되나요?
JPEG, PNG, WebP를 지원합니다. 최적의 성능을 위해 입력 이미지를 10 MB 이하로 유지하세요.
편집 전반에 걸쳐 캐릭터 정체성을 유지할 수 있나요?
네 — Kontext는 배경, 의상, 장면 요소를 편집할 때 캐릭터 일관성을 보존하도록 설계되었습니다.
생성 속도는 얼마나 빠른가요?
복잡도와 변형에 따라 일반적으로 이미지당 3~5초가 소요됩니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
유사 모델