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:

ParameterRequiredTypeDescription
promptYesstringText description for the sticker. Be specific and descriptive for best results
negative_promptOptionalstringDefault: null, Things you do not want in the image (e.g., "blurry, low quality, text")
widthOptionalnumberDefault: 1152, Width of output image in pixels. Valid range: 256-2048
heightOptionalnumberDefault: 1152, Height of output image in pixels. Valid range: 256-2048
number_of_imagesOptionalnumberDefault: 1, Number of stickers to generate. Valid range: 1-10
output_formatOptionalstringDefault: "webp", Output image format. Values: "webp", "jpg", "png"
output_qualityOptionalnumberDefault: 90, Image quality from 0 (lowest) to 100 (highest)
stepsOptionalnumberDefault: 17, Number of inference steps. More steps = better quality but slower
seedOptionalnumberDefault: null, Random seed for reproducibility. Use same seed for consistent results
webhookOptionalstringDefault: null, Callback URL for completion notification
webhook_events_filterOptionalarrayDefault: ["*"], 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

HeaderDescription
Content-Typeapplication/json
Cache-Controlno-cache
Ocp-Apim-Subscription-KeyYour 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 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/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.