Skip to main content
POST
/
v2
/
image-utils
/
character-image-sheet
cURL
curl --request POST \
  --url https://api.tokenkit.co/v2/image-utils/character-image-sheet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'character_image=<string>' \
  --form 'character_prompt=<string>' \
  --form 'webhook_url=<string>' \
  --form resolution=2K \
  --form 0.character_image.0='@example-file' \
  --form 1.character_image.0='@example-file'
{
  "data": {
    "job_id": "job_123",
    "links": {
      "self": "/v1/jobs/job_123",
      "stream": "/v1/jobs/job_123/stream"
    }
  },
  "errors": null
}

​
Request body

multipart/form-data
  • character_image (file, optional): Character image input, max 15MB
  • character_prompt (string, optional): Text prompt to define the character
  • webhook_url (string, optional): Must be a valid URL
  • resolution ("2K" | "4K", optional): Defaults to "2K"

​
Validation rules

  • You must provide at least one of:
    • character_image
    • character_prompt
  • If both are missing, validation fails with:
    • "Must provide character_image or character_prompt."

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
character_image
required
​
character_prompt
string
​
webhook_url
string<uri>

Must be a valid URL

​
resolution
enum<string>
default:2K
Available options:
2K,
4K

Response

Job accepted

​
data
object
required
​
errors
unknown