chop-about

sealchop-image-api

SEALCHOP is a simple Chinese seal chop image Web API. You can create Chinese or Korean seal chops.

NOTE: This guide is for developers using the API to build software. If you simply want a colorful, custom seal chop, you can use the Chinese Seal Chop Generator.

Quick Start

To get started, you can simply type the following URL into your browser:

https://new.sealchop.com/

You should see something similar to this:

This is the default Chinese seal chop image. It appears when you type the base URL with no custom settings.

The dimensions of the PNG image are 1000 by 1000 pixels. All the preview images in this tutorial have been scaled down in size for your convenience.

Making your own chop is easy! You can make a custom chop by adding parameters to the base seal chop image URL.

Chinese name chop

For example, you can change the Chinese name by simply setting the x parameter as follows:

https://new.sealchop.com/?x=貝聿銘

This will change the seal chop image into something similar to the image below:

Korean name chop

You can also use Korean characters to create Korean seal chops.

For example, instead of entering a Chinese name, you can enter the following Korean name to change the image:

https://new.sealchop.com/?x=소정희

The image now becomes a Korean seal chop.

At this time, you may enter 1, 2 or 3 characters for the Chinese or Korean seal chop name.

NOTE: Many operating systems require the addition of language keyboards or input method editors to enter Chinese or Korean characters.

Colors

Paper Color

If you are viewing this documention in dark mode, you may have noticed that the four white corners of the seal chop image stand out against the black background.

To allow the chop to better blend with its context, the p (paper) parameter can be changed as follows:

https://new.sealchop.com/?p=000000

The color 000000 is black, as defined by the hex triplet (6-digit hexadecimal).

Now, this image blends with the black background:

Background Color

This is the most prominent color in the seal chop image.

https://new.sealchop.com/?b=FF6600

The image background section is now a shade of orange (FF6600) and looks similar to the image below:

Foreground Color

This color provides a text area for the Chinese or Korean text.

You can change the foreground color using the f parameter:

https://new.sealchop.com/?f=FFFF00

The image foreground is now yellow (FFFF00) and looks similar to the image below:

Ink Color

This is the color of the Chinese or Korean text.

You can change the ink color using the i parameter:

https://new.sealchop.com/?i=0000FF

The image text is now blue (0000FF).

Combining parameters

You can combine the parameters using the & (ampersand) between parameters

For example:

https://new.sealchop.com/?i=0000FF&f=00FF00&b=FF00FF

You will get a resultant image similar to this:

Reference Modes

Combinations of the Chinese seal chop image parameters provide different “style modes” for different practical uses. There are no special parameters for these modes. Instead, the description of these modes help organize functionality in various user experiences.

Block Mode

Block mode defines when the condition the paper color (p), background color (b), and foreground color (f) are all the same in the Chinese seal chop image. This style mode is useful if you want to make single-character stickers or iPhone lockscreen wallpaper with one background color. The round edges of the background and foreground areas have disappeared, which makes the image look like a block.

Smooth Mode

Smooth mode describes when the background color and the foreground color are exactly the same. The smoothness of the background area rounded corners are often contrasted by a white background.

Stamp Mode

Stamp mode describes when the background color and the ink color are exactly the same, while the paper color and foreground color also match. The resulting image looks like someone pressed an ink pad before stamping the image on paper.

Themes

Plays well with others

MOO

Add a Chinese seal chop to business cards or stationery.

Sticker Mule

In Sticker Mule Studio, you can upload the saved PNG seal chop image from your desktop or online photo library.

Google Workspaces

Supported apps:

Version

This is Version 8 of the seal chop image API.

Synopsis

The following is a synopsis of the seal chop image API parameters:

- data type notes
x UTF-8 encoded Chinese or Korean character text “xingming”, the personal name. Non-Chinese or non-Korean characters are ignored
p 6-digit hexadecimal color text (hex triplet) “paper”, the color below the chop. Only valid hex colors are accepted. All other input ignored.
b 6-digit hexadecimal color text (hex triplet) “background”, the most prominent chop color. Only valid hex colors are accepted. All other input ignored.
f 6-digit hexadecimal color text (hex triplet) “foreground”, the text area for the ink. Only valid hex colors are accepted. All other input ignored.
i 6-digit hexadecimal color text (hex triplet) “ink”, the characters in the foreground. Only valid hex colors are accepted. All other input ignored.