Characters

Create a character

Keeps a character from 1 to 4 pictures you uploaded (POST /v1/files) or made (POST /v1/generations/{id}/outputs/{index}/file). Leap reads its look from them once. From then on, pass its chr_... ID wherever a model or recipe takes an image file: a list such as images gets all its pictures, a single image input its first. Free; a workspace keeps up to 200.

Needs an API key with the generations:write scope.

post/v1/characters

Request

  • Base URL: https://api.tryleap.ai
  • URL: https://api.tryleap.ai/v1/characters
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

namestring required

What you call the character, up to 40 characters. Leap never puts it in a picture unless your prompt does.

imagesstring[] required

1 to 4 pictures of the character, by file ID (file_..., from POST /v1/files or a run's result). The first one shows it; more angles keep it closer.

Response

The character.

idstring required

The character's ID, chr_.... Pass it wherever a model or recipe takes an image file.

object'character' required
betatrue required

This endpoint is in beta: its shape can change, or it can go away, without the 180-day notice stable endpoints get.

namestring required

The character's name.

created_atstring date-time required

When it was made.

updated_atstring date-time required

When its name or pictures last changed.

Changes

No recorded changes to this operation across all 1 revision of this API.