AI Face to Sticker API Documentation

Sticker Request - Request Code

POST https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image": "https://example.com/face-photo.jpg",
  "prompt": "a person, sticker style",
  "width": 1024,
  "height": 1024
}
import requests

url = "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate"

headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

data = {
    "image": "https://example.com/face-photo.jpg",
    "prompt": "a person, sticker style",
    "width": 1024,
    "height": 1024
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate';

const data = {
  image: 'https://example.com/face-photo.jpg',
  prompt: 'a person, sticker style',
  width: 1024,
  height: 1024
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "image": "https://example.com/face-photo.jpg",
    "prompt": "a person, sticker style",
    "width": 1024,
    "height": 1024
  }'
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class FaceStickerExample {
    public static void main(String[] args) throws Exception {
        String url = "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate";
        
        String json = "{" + "\n" +
        "  \"image\": \"https://example.com/face-photo.jpg\"," + "\n" +
        "  \"prompt\": \"a person, sticker style\"," + "\n" +
        "  \"width\": 1024," + "\n" +
        "  \"height\": 1024" + "\n" +
        "}";
        
        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();
            
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Content-Type", "application/json")
            .header("Cache-Control", "no-cache")
            .header("Ocp-Apim-Subscription-Key", "YOUR_SUBSCRIPTION_KEY")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();
            
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
<?php
$url = 'https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/generate';

$data = [
    'image' => 'https://example.com/face-photo.jpg',
    'prompt' => 'a person, sticker style',
    'width' => 1024,
    'height' => 1024
];

$options = [
    'http' => [
        'header' => "Content-Type: application/json\r\n" .
                   "Cache-Control: no-cache\r\n" .
                   "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY\r\n",
        'method' => 'POST',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

Output

Successful API response:

{
  "success": true,
  "request_id": "abc123def456",
  "status": "starting"
}

Request Body - Sticker Request

Parameters for /face-to-sticker/generate:

ParameterRequiredTypeDescription
imageYesstringURL of the face image to convert to sticker. Must be a valid image URL
promptNostringDefault: "a person", Description of the desired sticker style
negative_promptNostringDefault: "", Things you do not want in the sticker
widthNonumberDefault: 1024, Width in pixels. Valid range: 256-2048
heightNonumberDefault: 1024, Height in pixels. Valid range: 256-2048
stepsNonumberDefault: 20, Number of generation steps. Valid range: 1-50
seedNonumberDefault: random, Random seed for reproducibility
prompt_strengthNonumberDefault: 7, CFG scale (0-20). Higher = stronger prompt, lower = more likeness
instant_id_strengthNonumberDefault: 1, How strong the face matching will be (0-1)
ip_adapter_weightNonumberDefault: 0.2, How much the IP adapter influences the image (0-1)
ip_adapter_noiseNonumberDefault: 0.5, Noise added to IP adapter input (0-1)
upscaleNobooleanDefault: false, Enable 2x upscaling
upscale_stepsNonumberDefault: 10, Number of upscaling steps (1-50)
webhookNostringDefault: null, Callback URL for completion notification
webhook_events_filterNoarrayDefault: ["*"], Events that trigger webhook

Example Request - Sticker Request

JSON
{
  "image": "https://example.com/face-photo.jpg",
  "prompt": "a person, sticker style",
  "width": 1024,
  "height": 1024
}

Response - Sticker Request

JSON
{
  "success": true,
  "request_id": "abc123def456",
  "status": "starting",
  "input": {
    "image": "https://example.com/my-photo.jpg",
    "prompt": "a person, cartoon style, vibrant colors",
    "width": 1024,
    "height": 1024,
    "steps": 20,
    "prompt_strength": 7,
    "instant_id_strength": 1,
    "ip_adapter_weight": 0.2,
    "ip_adapter_noise": 0.5,
    "upscale": false,
    "upscale_steps": 10
  },
  "created_at": "2025-12-30T10:00:00.000Z"
}

Request Headers

HeaderDescription
Content-Typeapplication/json
Cache-Controlno-cache
Ocp-Apim-Subscription-KeyYour subscription key for authentication

Response Handling

The Face Sticker returns specific HTTP status codes and response bodies to indicate the success or failure of a request. Developers should implement error handling in their applications to manage these responses effectively.

Common Status Codes and Responses

Status CodeDescriptionResponse Body
200Success - The request was successfully processed.{ "success": true, ... }
Bad Request - The request contains invalid parameters or missing fields.{ "error": "Invalid request parameters" }
401Unauthorized - The provided subscription key is missing or invalid.{ "error": "Invalid or missing authentication" }
403Forbidden - The subscription does not have access to this API or action.{ "error": "Access denied for this operation" }
404Not Found - The requested resource or endpoint could not be found.{ "error": "Endpoint not found" }
Too Many Requests - The request rate limit has been exceeded.{ "error": "Rate limit exceeded, please retry later" }
500Internal Server Error - An unexpected error occurred on the server.{ "error": "An unexpected error occurred, please try again later" }

Example Error Response

{
  "error": "Invalid parameters"
}

Retrieving Results

After submitting your request, use this endpoint to check status and retrieve results.

Endpoint

POST https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction

Request Body

{
  "requestId": "abc123def456"
}
POST https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "requestId": "abc123def456"
}
import requests

url = "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction"

headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}

data = {
    "requestId": "abc123def456"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction';

const data = {
  requestId: 'abc123def456'
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "requestId": "abc123def456"
  }'
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class FaceStickerPollingExample {
    public static void main(String[] args) throws Exception {
        String url = "https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction";
        
        String json = "{" + "\n" +
        "  \"requestId\": \"abc123def456\"" + "\n" +
        "}";
        
        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();
            
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Content-Type", "application/json")
            .header("Cache-Control", "no-cache")
            .header("Ocp-Apim-Subscription-Key", "YOUR_SUBSCRIPTION_KEY")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();
            
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
<?php
$url = 'https://gateway.pixazo.ai/face-sticker/v1/face-to-sticker/prediction';

$data = [
    'requestId' => 'abc123def456'
];

$options = [
    'http' => [
        'header' => "Content-Type: application/json\r\n" .
                   "Cache-Control: no-cache\r\n" .
                   "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY\r\n",
        'method' => 'POST',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

AI Face to Sticker API Pricing

Resolution Price (USD)
All Resolution$0.025

Ready to generate AI Face to Sticker API assets?

Start with an API key, then automate your pipeline.