Guide · 8 min read
Create a reusable AI character
Build a look once. Reuse it on presets and video jobs with input.character.
client.characters.create takes a name, family (realistic or anime), and ethnicity. The response is a job plus a public id such as char_42.
Poll client.characters.get(id) until status is ready. Then POST /v2/jobs with a preset or a video model and input.character. List, delete, and regenerate live on the same helpers.
A stable character id you can keep in your own database and reuse across jobs.
Steps
- 1
Call client.characters.create with name, family, and ethnicity.
- 2
Poll client.characters.get until status is ready.
- 3
Reuse the char_ id on presets or video jobs.
- 4
Store the id in your own database.
Install the SDK
pip install "goonify @ git+https://github.com/Goonify/goonify.git#subdirectory=sdks/python"Modelgoonify/create-character
from goonify import Goonify
client = Goonify()
created = client.characters.create(
name="Ava",
family="realistic",
ethnicity="white",
appearance={"hair_color": "blonde", "eye_color": "blue"},
)
character_id = created["character"]
ready = client.characters.get(character_id)
# Poll until ready["status"] == "ready", then:
job = client.run(
"goonify/presets/missionary",
input={"character": character_id},
)
print(job.output["url"])What it looks like
Run it with a sandbox key
Sandbox keys return example media and spend nothing. Switch to a live key when you are ready.
