References and elements

Three ways in

The file type comes from the bytes, never the name or header. Images up to 20 MB, video up to 200 MB, audio up to 30 MB. The same file uploaded twice is stored once. Every asset comes back with a signed URL valid for an hour; that is also how providers fetch it. Uploads are deleted after 60 days, with the outputs.

# upload a frame
curl https://edengen.ai/v1/assets -H "Authorization: Bearer $TAKES_API_KEY"   -H "Content-Type: image/png" -H "X-Filename: frame.png" --data-binary @frame.png

# animate it
curl https://edengen.ai/v1/takes -H "Authorization: Bearer $TAKES_API_KEY" -H "Content-Type: application/json" -H "Prefer: wait=60"   -d '{"model":"kling-3","prompt":"She turns to the window, no music, no cut","resolution":"720p","duration":5,
       "references":[{"asset_id":"as_...","role":"first_frame"}]}'

Roles

What each model accepts

Ask for something a model cannot take and the request fails before anything is charged, naming what it does accept. Video or audio references route Seedance and MiniMax to their reference-to-video endpoints automatically.

Elements

An element is a named set of up to 9 images: a character, product, location or style. Pass { element_id } and it expands to its images, so the same face or packshot follows you across shots and models. Notes on the element are for you and your agents to reuse in prompts.

from takes import Takes
client = Takes(base_url="https://edengen.ai")

faces = [client.assets.upload(p)["id"] for p in ["anna-front.png", "anna-34.png", "anna-full.png"]]
anna = client.elements.create("Anna", faces, kind="character", notes="freckles, green eyes, leather jacket")
take = client.takes.run(model="kling-omni", prompt="Anna walks into the rain, no music",
                        resolution="1080p", duration=5, references=[{"element_id": anna["id"]}])

From agents

MCP tools: takes_create_upload_link (returns a curl command the agent runs locally), takes_import_reference (URL or take), takes_list_references, takes_create_element, and references on takes_create.