Tencent ARCMediumHigh

PhotoMaker

Generate stylized photos of a person from 1-4 reference photos (9M+ runs). Ten styles including Cinematic, Disney Character, and Digital Art — keep the identity, change everything else.

10 credits

per image (num_outputs billed per image)

Identity-preserving generation from 1-4 photos

10 built-in styles

Prompt-controlled scenes and outfits

Up to 4 outputs per run (billed per image)

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

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
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	No	A photo of a person img	Scene description. Must include the trigger word 'img' after the class noun (e.g. 'a photo of a man img')
`input_image`	string	Yes	-	Reference photo of the person (input_image2-4 for more)
`input_image2`	string	No	-	Additional input image (optional)
`input_image3`	string	No	-	Additional input image (optional)
`input_image4`	string	No	-	Additional input image (optional)
`style_name`	string	No	Photographic (Default)	Built-in style preset (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	Negative Prompt. The negative prompt should NOT contain the trigger word.
`num_steps`	integer	No	20	Denoising steps (1-100)
`style_strength_ratio`	number	No	20	Style strength (15-50). Higher applies the style harder
`num_outputs`	integer	No	1	Number of images (1-4). Billed per image
`guidance_scale`	number	No	5	Guidance scale. A guidance scale of 1 corresponds to doing no classifier free guidance.
`seed`	integer	No	-	Random seed
`disable_safety_checker`	boolean	No	false	Disable safety checker for generated images.

How to Provide File Input

There are 3 ways to provide files for the input_image parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

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"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "tencentarc/photomaker",
  "input": {
    "prompt": "your prompt here",
    "input_image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Cinematic Avatar

Cinematic-style portraits from one reference photo

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
  }
}'