Fal.AI를 통해 제공되는 Kuaishou의 Kling Omni 3(O3) 이미지-이미지 모델입니다. 프롬프트에서 @Image1 / @Element1로 지목한 최대 10장의 참조 이미지를 1K/2K/4K에서 단일 이미지 또는 2-9장의 연관 시리즈로 편집·변환하며 시각적 일관성을 유지합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/kling-image/o3/image-to-image",
"input": {
"prompt": "Transform into photorealistic 3D render, add proper lighting and shadows, realistic materials and textures, maintain exact proportions and design from sketch, product visualization quality",
"image_urls": [
"https://v3b.fal.media/files/b/0a8d06d1/FTrwBsV9WI5twqMPkqvRh_19db9852c5ed4a109d81c52d27c9e433.png"
],
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png",
"num_images": 1
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 텍스트 프롬프트입니다(최대 2,500자). 입력 이미지는 @Image1, @Image2, ...(한 장이면 @Image), 캐릭터 요소는 @Element1, @Element2, ...로 지목합니다. |
image_urls | array | Yes | - | 참조 이미지 목록입니다. 프롬프트에서 @Image1, @Image2, ...로 1부터 지목하며 최대 10장입니다. |
elements | array | No | - | 얼굴·정체성 제어용 캐릭터나 오브젝트로, 프롬프트에서 @Element1, @Element2, ...로 지목합니다. 각 요소에는 frontal_image_url과 선택적 reference_image_urls를 넣습니다. |
resolution | string | No | 1K | 출력 해상도입니다. 1K·2K는 같은 가격이고 4K는 이미지당 두 배입니다. 1K2K4K |
result_type | string | No | single | 'single'은 num_images개의 독립 이미지를, 'series'는 series_amount개의 연관된 이미지 세트를 생성합니다. singleseries |
num_images | integer | No | 1 | result_type이 'single'일 때 생성할 이미지 수(1-9)입니다. 이미지당 과금됩니다. |
series_amount | integer | No | - | 시리즈에 포함할 이미지 수(2-9)입니다. result_type이 'series'일 때 필수이며 이미지당 과금됩니다. |
aspect_ratio | string | No | auto | 생성 이미지의 화면 비율입니다. 'auto'는 입력 내용에 맞춰 자동으로 고릅니다. auto16:99:161:14:33:43:22:321:9 |
output_format | string | No | png | 생성 이미지의 파일 형식입니다. jpegpngwebp |
이 모델의 image_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "fal-ai/kling-image/o3/image-to-image",
"input": {
"prompt": "your prompt here",
"image_urls": ["https://example.com/image.jpg"]
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=fal-ai/kling-image/o3/image-to-image" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_urls=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
제품 스케치를 1K 사실적 렌더로 변환합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/kling-image/o3/image-to-image",
"input": {
"prompt": "Transform into photorealistic 3D render, add proper lighting and shadows, realistic materials and textures, maintain exact proportions and design from sketch, product visualization quality",
"image_urls": [
"https://v3b.fal.media/files/b/0a8d06d1/FTrwBsV9WI5twqMPkqvRh_19db9852c5ed4a109d81c52d27c9e433.png"
],
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png",
"num_images": 1
}
}'같은 변환을 인쇄용 4K로 생성합니다(이미지당 가격 두 배).
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "fal-ai/kling-image/o3/image-to-image",
"input": {
"prompt": "Transform @Image into a studio product photo on a white seamless background with soft shadows",
"image_urls": [
"https://v3b.fal.media/files/b/0a8d06d1/FTrwBsV9WI5twqMPkqvRh_19db9852c5ed4a109d81c52d27c9e433.png"
],
"resolution": "4K"
}
}'