# Face to Sticker - Core.Today AI API

> Turn any face photo into a fun die-cut sticker (1.6M+ runs). InstantID keeps the likeness while IP-Adapter controls take the artwork from faithful caricature to loose cartoon — with an optional 2x upscale for print quality.

- **Provider**: fofr
- **Model ID**: fofr/face-to-sticker
- **Category**: Image Generation
- **Credits**: 22 per run (43 credits when upscale is true)
- **Speed**: Fast
- **Quality**: High

## Features
- One face photo in, sticker-style artwork out
- InstantID-based likeness with instant_id_strength control
- ip_adapter_weight and prompt_strength to balance likeness vs style
- Optional 2x upscale for crisp, print-ready stickers
- Popular community model by fofr with 1.6M+ runs

## Use Cases
- Personalized chat and messenger sticker packs
- Team or community avatar stickers
- Stream emotes and Discord server art
- Printed die-cut sticker merchandise
- Event badges and fun profile graphics

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Optional
- **prompt**: string (default: a person) - What the sticker should depict (character, outfit, theme)
- **image**: string - An image of a person to be converted to a sticker
- **negative_prompt**: string - Things you do not want in the image
- **width**: integer (default: 1024) - Output width in pixels
- **height**: integer (default: 1024) - Output height in pixels
- **steps**: integer (default: 20) - steps
- **seed**: integer - Fix the random seed for reproducibility
- **prompt_strength**: number (default: 7) - CFG scale — higher follows the prompt harder, lower keeps more of the original likeness
- **instant_id_strength**: number (default: 1) - How strong the InstantID face likeness will be (0-1)
- **ip_adapter_weight**: number (default: 0.2) - How much the IP adapter (input image) will influence the image (0-1)
- **ip_adapter_noise**: number (default: 0.5) - How much noise is added to the IP adapter input
- **upscale**: boolean (default: false) - 2x upscale the sticker (doubles the cost to 56 credits)
- **upscale_steps**: integer (default: 10) - Number of steps to upscale

## Examples

### Action-Hero Sticker
A face photo turned into a stylized character sticker
```json
{
  "model": "fofr/face-to-sticker",
  "input": {
    "image": "https://example.com/face.webp",
    "prompt": "arnold",
    "prompt_strength": 4.5,
    "instant_id_strength": 0.7,
    "ip_adapter_weight": 0.2,
    "upscale": false
  }
}
```

### Print-Ready Upscaled Sticker
2x upscale for merchandise printing (56 credits)
```json
{
  "model": "fofr/face-to-sticker",
  "input": {
    "image": "https://example.com/face.jpg",
    "prompt": "a person, astronaut helmet, cute cartoon style",
    "upscale": true,
    "upscale_steps": 10
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Lower prompt_strength (around 4-5) keeps more of the original face; higher pushes the prompt style
- If the sticker doesn't look like the person, raise instant_id_strength toward 1
- Keep ip_adapter_weight low (0.2 or so) for clean sticker styling — high values copy too much of the photo
- upscale: true doubles the cost to 56 credits — iterate at 28 credits, upscale only the winner
- Only use photos of real people with their consent

## Documentation
https://replicate.com/fofr/face-to-sticker