Documentation

Cartoon conversion

Turn a photo into cartoon or character styles.

Turn a photo into a cartoon or themed character look. Useful for avatars, social content, or playful brand assets.

URL: POST https://api.thefluxtrain.com/api/v1/image-generate/cartoon-converter/convert

Authentication: x-api-key

Request body

Field	Type	Required	Default	Description
`image`	string	Yes	—	Input image URL or data URI
`action`	string	Yes	—	Style action (see below)
`gender`	string	No	`male`	`male` or `female` (filters compatible actions)
`aspect_ratio`	string	No	`match_input_image`	Output aspect ratio
`output_format`	string	No	`png`	`jpg` or `png`
`prompt_upsampling`	boolean	No	`false`	Enable prompt upsampling
`folder_id`	string	No	—	Folder UUID in your account
`project_id`	string	No	—	Optional project ID
`message_id`	string	No	—	Your own tracking ID

action values: cartoonify, plain, adventurer, knight, futuristic, schoolkid, superhero, spider-boy, spider-girl, super-boy, super-girl

Example

{
  "image": "https://example.com/photo.jpg",
  "action": "cartoonify",
  "gender": "female",
  "folder_id": "your-folder-uuid"
}

Response

Field	Type	Description
`id`	string	Job ID
`url`	string	Cartoon image URL
`status`	string	Generation status
`media_type`	string	`IMAGE`
`meta`	object	Metadata
`created_at`	string \| null	ISO 8601 timestamp
`message_id`	string \| null	Your tracking ID if sent

Example

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://storage.example/cartoon.png",
    "status": "SUCCESS",
    "media_type": "IMAGE",
    "meta": {},
    "created_at": "2026-05-30T12:00:00Z"
  },
  "error": null
}