레퍼런스 사진 1-4장으로 인물의 스타일 사진을 생성합니다 (900만+ 실행). Cinematic, Disney Character, Digital Art 등 10가지 스타일 — 얼굴 정체성은 유지하고 나머지를 바꿉니다.
콘솔의 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": "tencentarc/photomaker",
"input": {
"input_image": "https://example.com/selfie.jpg",
"prompt": "portrait photo of a man img, city night background, dramatic lighting",
"style_name": "Cinematic",
"num_outputs": 2
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | No | A photo of a person img | 장면 설명. 반드시 명사 뒤에 트리거 단어 'img'를 포함하세요 (예: 'a photo of a man img') |
input_image | string | Yes | - | 인물 레퍼런스 사진 (추가는 input_image2-4) |
input_image2 | string | No | - | 추가 입력 이미지 (선택) |
input_image3 | string | No | - | 추가 입력 이미지 (선택) |
input_image4 | string | No | - | 추가 입력 이미지 (선택) |
style_name | string | No | Photographic (Default) | 내장 스타일 프리셋 (No style)CinematicDisney CharactorDigital ArtPhotographic (Default)Fantasy artNeonpunkEnhanceComic bookLowpolyLine art |
negative_prompt | string | No | nsfw, lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality, normal quality, jpeg artifacts, signature, watermark, username, blurry | 네거티브 프롬프트. 트리거 단어를 포함하면 안 됩니다. |
num_steps | integer | No | 20 | 디노이징 스텝 (1-100) |
style_strength_ratio | number | No | 20 | 스타일 강도 (15-50). 높을수록 스타일이 강하게 적용 |
num_outputs | integer | No | 1 | 생성할 이미지 수 (1-4). 이미지 수만큼 과금 |
guidance_scale | number | No | 5 | 가이던스 스케일. 1은 classifier-free guidance를 적용하지 않음을 의미합니다. |
seed | integer | No | - | 시드 |
disable_safety_checker | boolean | No | false | 생성된 이미지의 안전성 검사기 비활성화. |
이 모델의 input_image 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=tencentarc/photomaker" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:input_image=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "tencentarc/photomaker",
"input": {
"prompt": "your prompt here",
"input_image": "https://example.com/image.jpg"
}
}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로도 제공 |
레퍼런스 1장으로 시네마틱 인물 사진 생성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tencentarc/photomaker",
"input": {
"input_image": "https://example.com/selfie.jpg",
"prompt": "portrait photo of a man img, city night background, dramatic lighting",
"style_name": "Cinematic",
"num_outputs": 2
}
}'