API Documentation
Endpoints
Create an emoji
Create an emoji.
POST
/
api
/
v1
/
emojis
Copy
curl --request POST \
--url https://api.emojis.com/api/v1/emojis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"kind": "face_to_emoji",
"prompt": "dinosaur wearing a tophat",
"image_url": "https://example.com/image.png",
"enable_prompt_safety_check": true
}'
Copy
{
"id": "F5LKv2Gttog",
"name": "happy green dino wearing santa hat",
"status": "generating",
"error": "no face detected",
"formats": {
"png": {
"128": "https://imgproxy.attic.sh/dT0BPRBTjUzztiQCdYSZe2sjojVeMEwlFTnVGve5EI0/rs:fit:128:128:1:1/t:1:FF00FF:false:false/pngo:false:true:256/aHR0cHM6Ly9hdHRp/Yy5zaC82MXJ3Zmoy/OTNxNGxpZzRxcG53/N2E5bTIxd3p1.png",
"512": "https://imgproxy.attic.sh/dT0BPRBTjUzztiQCdYSZe2sjojVeMEwlFTnVGve5EI0/rs:fit:512:512:1:1/t:1:FF00FF:false:false/pngo:false:true:256/aHR0cHM6Ly9hdHRp/Yy5zaC82MXJ3Zmoy/OTNxNGxpZzRxcG53/N2E5bTIxd3p1.png"
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
200 - application/json
Successful response
The response is of type object
.
Was this page helpful?
Copy
curl --request POST \
--url https://api.emojis.com/api/v1/emojis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"kind": "face_to_emoji",
"prompt": "dinosaur wearing a tophat",
"image_url": "https://example.com/image.png",
"enable_prompt_safety_check": true
}'
Copy
{
"id": "F5LKv2Gttog",
"name": "happy green dino wearing santa hat",
"status": "generating",
"error": "no face detected",
"formats": {
"png": {
"128": "https://imgproxy.attic.sh/dT0BPRBTjUzztiQCdYSZe2sjojVeMEwlFTnVGve5EI0/rs:fit:128:128:1:1/t:1:FF00FF:false:false/pngo:false:true:256/aHR0cHM6Ly9hdHRp/Yy5zaC82MXJ3Zmoy/OTNxNGxpZzRxcG53/N2E5bTIxd3p1.png",
"512": "https://imgproxy.attic.sh/dT0BPRBTjUzztiQCdYSZe2sjojVeMEwlFTnVGve5EI0/rs:fit:512:512:1:1/t:1:FF00FF:false:false/pngo:false:true:256/aHR0cHM6Ly9hdHRp/Yy5zaC82MXJ3Zmoy/OTNxNGxpZzRxcG53/N2E5bTIxd3p1.png"
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.