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:
| Parameter | Required | Type | Description |
|---|---|---|---|
| image | Yes | string | URL of the face image to convert to sticker. Must be a valid image URL |
| prompt | No | string | Default: "a person", Description of the desired sticker style |
| negative_prompt | No | string | Default: "", Things you do not want in the sticker |
| width | No | number | Default: 1024, Width in pixels. Valid range: 256-2048 |
| height | No | number | Default: 1024, Height in pixels. Valid range: 256-2048 |
| steps | No | number | Default: 20, Number of generation steps. Valid range: 1-50 |
| seed | No | number | Default: random, Random seed for reproducibility |
| prompt_strength | No | number | Default: 7, CFG scale (0-20). Higher = stronger prompt, lower = more likeness |
| instant_id_strength | No | number | Default: 1, How strong the face matching will be (0-1) |
| ip_adapter_weight | No | number | Default: 0.2, How much the IP adapter influences the image (0-1) |
| ip_adapter_noise | No | number | Default: 0.5, Noise added to IP adapter input (0-1) |
| upscale | No | boolean | Default: false, Enable 2x upscaling |
| upscale_steps | No | number | Default: 10, Number of upscaling steps (1-50) |
| webhook | No | string | Default: null, Callback URL for completion notification |
| webhook_events_filter | No | array | Default: ["*"], 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
| Header | Description |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | Your 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 Code | Description | Response Body |
|---|---|---|
| 200 | Success - The request was successfully processed. | { "success": true, ... } |
| 400 | Bad Request - The request contains invalid parameters or missing fields. | { "error": "Invalid request parameters" } |
| 401 | Unauthorized - The provided subscription key is missing or invalid. | { "error": "Invalid or missing authentication" } |
| 403 | Forbidden - The subscription does not have access to this API or action. | { "error": "Access denied for this operation" } |
| 404 | Not Found - The requested resource or endpoint could not be found. | { "error": "Endpoint not found" } |
| 429 | Too Many Requests - The request rate limit has been exceeded. | { "error": "Rate limit exceeded, please retry later" } |
| 500 | Internal 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.
