Skip to main content
Black Forest Labs보통울트라

FLUX Kontext Pro

자연어로 이미지를 변환하는 최첨단 텍스트 기반 이미지 편집 모델입니다. 스타일 전환, 객체 수정, 텍스트 교체, 배경 변경, 캐릭터 일관성 작업에 뛰어납니다.

120 크레딧
이미지당
고품질 텍스트 기반 이미지 편집
스타일 전환 및 변환
객체 및 텍스트 교체
배경 편집
편집 시 캐릭터 일관성 유지

지금 바로 실행해보세요

콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요

로그인 후 사용해보기

AI 어시스턴트에서 사용하기

이 모델의 사용법을 Claude, ChatGPT 등에 복사

llms.txt

빠른 시작

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "black-forest-labs/flux-kontext-pro",
  "input": {
    "prompt": "Make this a 90s cartoon",
    "input_image": "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
    "aspect_ratio": "match_input_image",
    "output_format": "jpg",
    "safety_tolerance": 2
  }
}'

파라미터

파라미터타입필수기본값설명
promptstringYes-편집 지시문 또는 생성 프롬프트
input_imagestringNo-편집할 원본 이미지 URL (jpeg, png, gif, webp)
aspect_ratiostringNomatch_input_image출력 비율. match_input_image 사용 시 입력 이미지 비율 유지
match_input_image1:116:99:164:33:43:22:34:55:421:99:212:11:2
output_formatstringNopng출력 이미지 포맷
jpgpng
safety_toleranceintegerNo2안전 허용 수준: 0이 가장 엄격, 6이 가장 관대. input_image 사용 시 최대 2
prompt_upsamplingbooleanNofalse생성 전 프롬프트 자동 개선
seedintegerNo-재현성을 위한 시드

파일 입력 방법

이 모델의 input_image 파라미터에 파일을 전달하는 방법은 3가지입니다.

추천

간편 업로드 (Multipart)

POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=black-forest-labs/flux-kontext-pro" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:input_image=@your_file.png"

이미지 URL 전달

공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.

{
  "model": "black-forest-labs/flux-kontext-pro",
  "input": {
    "prompt": "your prompt here",
    "input_image": "https://example.com/image.jpg"
  }
}
File Upload 문서에서 Presigned URL 방식 등 더 자세한 업로드 방법을 확인하세요.

공통 파라미터

POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.

파라미터타입필수기본값설명
modelstringYes-모델 식별자
inputobjectYes-위 테이블의 모델별 파라미터를 포함하는 객체
output_folderstringNo-결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가)
webhook_urlstringNo-완료 시 호출할 Webhook URL
is_publicbooleanNofalsetrue 시 결과물을 영구 공개 URL로도 제공

예제

스타일 전환

사진을 90년대 만화 스타일로 변환

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "black-forest-labs/flux-kontext-pro",
  "input": {
    "prompt": "Make this a 90s cartoon",
    "input_image": "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
    "aspect_ratio": "match_input_image",
    "output_format": "jpg",
    "safety_tolerance": 2
  }
}'

팁 & 모범 사례

1편집 모드는 input_image 지정 필요 — 미지정 시 새로 생성합니다
2원본 비율을 유지하려면 match_input_image를 사용하세요
3낮은 safety_tolerance는 더 많은 결과를 거부합니다 — 2부터 시작하세요
4단일 편집을 반복할 때는 고정 시드를 사용하세요

사용 사례

사진 보정 및 스타일링
마케팅 크리에이티브 변형
제품 이미지 배경 교체
캐릭터 일관성을 유지하는 일러스트