Skip to main content
Tencent ARCFastHigh

GFPGAN

Tencent ARC's face restoration model โ€” 115M+ runs, the most-run model in the restoration collection. Restores old/blurry photos and fixes faces in AI-generated images.

6 credits
per image
115M+ runs โ€” the standard for face restoration
Restores old, blurry, or damaged photos
Fixes distorted faces in AI-generated images
Four versions incl. RestoreFormer
Adjustable rescaling factor

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

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/gfpgan",
  "input": {
    "img": "https://example.com/old-photo.jpg",
    "version": "v1.4",
    "scale": 2
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
imgstringYes-Input image with faces to restore
versionstringNov1.4v1.3: better quality. v1.4: more details and better identity. RestoreFormer: alternative architecture
v1.2v1.3v1.4RestoreFormer
scalenumberNo2Rescaling factor for the output

How to Provide File Input

There are 3 ways to provide files for the img 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/gfpgan" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:img=@your_file.png"

Image URL

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

{
  "model": "tencentarc/gfpgan",
  "input": {
    "prompt": "your prompt here",
    "img": "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.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Old Photo Restoration

Restore a blurry old family photo at 2x

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/gfpgan",
  "input": {
    "img": "https://example.com/old-photo.jpg",
    "version": "v1.4",
    "scale": 2
  }
}'

Tips & Best Practices

1v1.4 keeps identity best; try v1.3 if v1.4 looks over-sharpened
2Works on all detected faces in the image at once
3Pair with Real-ESRGAN (face_enhance) when you also need background upscaling
4For adjustable quality/fidelity balance, compare with CodeFormer

Use Cases

Old family photo restoration
Fixing AI-generated faces
Profile photo enhancement
Archive digitization cleanup
Low-quality selfie improvement