Rivya Public API v1에서 Flux Kontext Pro을 모델 ID flux-kontext-pro, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.

API로 사용 가능텍스트 또는 URL 준비됨; 참조 모드는 Files API 사용이미지

API 모델 ID

flux-kontext-pro

입력

text, file

Files API

참조 모드에 필요

기본 크레딧

기능

이미지

과금

FIXED

프롬프트 제한

문서화된 프롬프트 제한 없음

요청 계약

모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.

Key	유형	필수	기본값	설명
model	string	예	flux-kontext-pro	flux-kontext-pro을 API 모델 ID로 사용합니다.
prompt	string	예	-	텍스트 입력을 지원하는 모델에 보내는 프롬프트 텍스트입니다.
params	object	아니요	-	모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

Key	유형	필수	기본값	범위	옵션	설명
aspectRatio	select	아니요	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	화면 비율
outputFormat	select	아니요	jpeg	-	jpeg, png	JPEG는 용량이 더 작고, PNG는 투명도나 더 깔끔한 무손실 가장자리에 더 적합합니다.
enableTranslation	select	아니요	true	-	true, false	프롬프트 자동 번역
promptUpsampling	select	아니요	false	-	false, true	활성화하면 Rivya가 생성 전에 모델이 프롬프트를 확장하고 다듬도록 합니다. 디테일 품질에 도움이 되는 경우가 많지만, 결과가 원래 프롬프트보다 더 해석적으로 바뀔 수도 있습니다.
safetyTolerance	number	아니요	2	min 0 / max 6	-	콘텐츠 검수가 얼마나 엄격한지 제어합니다. 생성은 보통 편집보다 더 넓은 범위를 허용합니다. 낮은 값은 더 엄격하고 높은 값은 더 허용적입니다.
watermark	text	아니요	-	-	-	워터마크

업로드 정책

참조 파일을 먼저 업로드한 다음 반환된 URL과 durationToken을 params.referenceMediaItems 안에 넣으세요.

참조 규칙

참조 이미지: 이미지 편집 프로젝트에 사용할 이미지 파일을 최대 1개까지 업로드하세요.

최대 파일 수

허용되는 파일 종류

image

재생시간 토큰

재생시간 검증이 필요한 경우 비디오 및 오디오 참조는 /api/v1/files의 durationToken을 포함해야 합니다.

kind	최대 크기	MIME 유형
image	10 MB	image/jpeg, image/png, image/webp

최소 요청

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "선택 사항: 워터마크 텍스트"
  }
}

참조 파일 요청

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "선택 사항: 워터마크 텍스트",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

생성 응답

생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.

{
  "id": "task_flux_kontext_pro_example",
  "status": "queued",
  "model": "flux-kontext-pro",
  "reserved_credits": 4,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

일부 모드는 Files API 참조 업로드가 필요합니다.

Flux Kontext Pro API 연동