POST
/
pub
/
v1
/
characters
curl --request POST \
  --url https://api.rendernet.ai/pub/v1/characters \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "asset_id": "ast_123abc",
  "character_type": "realistic",
  "name": "character_01",
  "prompt": "a female, european, young adult, muscular body, thick black hair, wearing formal clothes, mountains in the background. "
}'
{
  "data": {
    "character_type": "realistic",
    "input_image": "https://redernet-image-data.s3.amazonaws.com/input_images/ast_123abc.png",
    "name": "character_01",
    "prompt": "a female, european, young adult, muscular body, thick black hair, wearing formal clothes, mountains in the background. ",
    "id": "character_001"
  },
  "err": {}
}

Headers

​
X-API-KEY
string
required

API key needed to access our public endpoints. You can find yours under the 'Account' section of the website

Body

application/json
​
asset_id
string
required

The asset_id of the image which you want to use as the character’s face image.

Example:

"ast_123abc"

​
character_type
enum<string>
required

Specify if the character’s face image passed in the asset_id is a realistic image or a stylized image. A ‘stylized’ image can refer to an illustration, drawing, digital render, or any other non-photographic style.

Available options:
realistic,
stylized
Example:

"realistic"

​
name
string
required

The name of the character which is unique from all your other characters

Example:

"character_01"

​
prompt
string
required

A short description of the character’s most important features. This can include gender, age, race/ethnicity, and body type. Avoid describing clothing and background since those have to be mentioned in the prompt while generating images.

Example:

"a female, european, young adult, muscular body, thick black hair, wearing formal clothes, mountains in the background. "

Response

201 - application/json
Successful response for created character
​
data
object
​
err
object

The error if the request was not successful