AI Sticker Maker API Documentation
Sticker Request - Request Code
POST https://gateway.pixazo.ai/sticker/v1/sticker-maker/generate HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"output_format": "png",
"output_quality": 100
} import requests
url = "https://gateway.pixazo.ai/sticker/v1/sticker-maker/generate"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"output_format": "png",
"output_quality": 100
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/sticker/v1/sticker-maker/generate';
const data = {
prompt: 'a cute cat sticker with big eyes',
width: 1152,
height: 1152,
output_format: 'png',
output_quality: 100
};
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/sticker/v1/sticker-maker/generate" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"output_format": "png",
"output_quality": 100
}'
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
import java.io.InputStream;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
URL url = new URL("https://gateway.pixazo.ai/sticker/v1/sticker-maker/generate");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("Cache-Control", "no-cache");
conn.setRequestProperty("Ocp-Apim-Subscription-Key", "YOUR_SUBSCRIPTION_KEY");
conn.setDoOutput(true);
String jsonInputString = "{" + "\n" +
" \"prompt\": \"a cute cat sticker with big eyes\"," + "\n" +
" \"width\": 1152," + "\n" +
" \"height\": 1152," + "\n" +
" \"output_format\": \"png\"," + "\n" +
" \"output_quality\": 100" + "\n" +
"}";
try (OutputStream os = conn.getOutputStream()) {
byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
os.write(input, 0, input.length);
}
try (BufferedReader br = new BufferedReader(
new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println(response.toString());
}
}
}
<?php
$url = 'https://gateway.pixazo.ai/sticker/v1/sticker-maker/generate';
$data = [
'prompt' => 'a cute cat sticker with big eyes',
'width' => 1152,
'height' => 1152,
'output_format' => 'png',
'output_quality' => 100
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Cache-Control: no-cache',
'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
Output
Successful API response:
{
"success": true,
"request_id": "abc123def456",
"status": "starting",
"input": {
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"number_of_images": 1,
"output_format": "webp",
"output_quality": 90,
"steps": 17
},
"created_at": "2025-12-29T10:00:00.000Z"
} Request Body - Sticker Request
Parameters for /sticker-maker/generate:
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | Text description for the sticker. Be specific and descriptive for best results |
| negative_prompt | Optional | string | Default: null, Things you do not want in the image (e.g., "blurry, low quality, text") |
| width | Optional | number | Default: 1152, Width of output image in pixels. Valid range: 256-2048 |
| height | Optional | number | Default: 1152, Height of output image in pixels. Valid range: 256-2048 |
| number_of_images | Optional | number | Default: 1, Number of stickers to generate. Valid range: 1-10 |
| output_format | Optional | string | Default: "webp", Output image format. Values: "webp", "jpg", "png" |
| output_quality | Optional | number | Default: 90, Image quality from 0 (lowest) to 100 (highest) |
| steps | Optional | number | Default: 17, Number of inference steps. More steps = better quality but slower |
| seed | Optional | number | Default: null, Random seed for reproducibility. Use same seed for consistent results |
| webhook | Optional | string | Default: null, Callback URL for completion notification |
| webhook_events_filter | Optional | array | Default: ["*"], Events that trigger webhook. Values: ["*"] (all), ["completed"] (success/failure only) |
Example Request - Sticker Request
JSON
{
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"output_format": "png",
"output_quality": 100
} Response - Sticker Request
JSON
{
"success": true,
"request_id": "abc123def456",
"status": "starting",
"input": {
"prompt": "a cute cat sticker with big eyes",
"width": 1152,
"height": 1152,
"number_of_images": 1,
"output_format": "webp",
"output_quality": 90,
"steps": 17
},
"created_at": "2025-12-29T10: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 Sticker Maker 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/sticker/v1/sticker-maker/prediction
Request Body
{ "requestId": "abc123def456" } POST https://gateway.pixazo.ai/sticker/v1/sticker-maker/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/sticker/v1/sticker-maker/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/sticker/v1/sticker-maker/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/sticker/v1/sticker-maker/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.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
import java.io.InputStream;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
URL url = new URL("https://gateway.pixazo.ai/sticker/v1/sticker-maker/prediction");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("Cache-Control", "no-cache");
conn.setRequestProperty("Ocp-Apim-Subscription-Key", "YOUR_SUBSCRIPTION_KEY");
conn.setDoOutput(true);
String jsonInputString = "{" + "\n" +
" \"requestId\": \"abc123def456\"" + "\n" +
"}";
try (OutputStream os = conn.getOutputStream()) {
byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
os.write(input, 0, input.length);
}
try (BufferedReader br = new BufferedReader(
new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println(response.toString());
}
}
}
<?php
$url = 'https://gateway.pixazo.ai/sticker/v1/sticker-maker/prediction';
$data = [
'requestId' => 'abc123def456'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Cache-Control: no-cache',
'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
AI Sticker Maker API Pricing
| Resolution | Price (USD) |
|---|---|
| All Resolution | $0.0022 |
Ready to generate AI Sticker Maker API assets?
Start with an API key, then automate your pipeline.
