Fal.AI를 통해 제공되는 Kuaishou의 Kling Omni 3(O3) 텍스트-이미지 모델입니다. 1K/2K/4K에서 일관성 높은 이미지를 단일 이미지 또는 2-9장의 연관 시리즈로 생성하며, 캐릭터 요소(@Element1)로 얼굴·정체성을 제어할 수 있습니다.
콘솔의 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/text-to-image",
"input": {
"prompt": "High fashion model wearing a dress made entirely of living moss and small white flowers, standing in an abandoned greenhouse, shafts of light, editorial photography.",
"resolution": "1K",
"aspect_ratio": "16:9",
"output_format": "png",
"num_images": 1
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 생성을 위한 텍스트 프롬프트입니다(최대 2,500자). 캐릭터 요소는 @Element1, @Element2, ...로 지목합니다. |
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 | 16:9 | 생성 이미지의 화면 비율입니다. 16:99:161:14:33:43:22:321:9 |
output_format | string | No | png | 생성 이미지의 파일 형식입니다. jpegpngwebp |
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로도 제공 |
16:9 비율의 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/text-to-image",
"input": {
"prompt": "High fashion model wearing a dress made entirely of living moss and small white flowers, standing in an abandoned greenhouse, shafts of light, editorial photography.",
"resolution": "1K",
"aspect_ratio": "16:9",
"output_format": "png",
"num_images": 1
}
}'2K로 생성하는 일관된 4장의 연관 이미지 시리즈입니다.
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/text-to-image",
"input": {
"prompt": "A small robot explores a rainy neon city: waking up, finding an umbrella, meeting a cat, watching the sunrise.",
"resolution": "2K",
"aspect_ratio": "3:4",
"result_type": "series",
"series_amount": 4
}
}'