Z-Image Turbo

Z-Image Turbo image edit uses the model id alibaba/z-image-turbo/image-edit. Very fast, very cheap drafts

1. Calling the API

Endpoint

Send a POST to https://api.elyum.ai/v1/generations with a JSON body matching the parameters below. Every model uses the same endpoint; the model field picks this one.

const res = await fetch("https://api.elyum.ai/v1/generations", {  method: "POST",  headers: {    Authorization: `Bearer ${process.env.ELYUM_API_KEY}`,    "Content-Type": "application/json",    Prefer: "wait=55",  },  body: JSON.stringify({    "model": "alibaba/z-image-turbo/image-edit",    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",    "inputs": [      {        "role": "reference",        "url": "https://example.com/reference.jpg"      }    ]  }),});const generation = await res.json();console.log(generation.status, generation.outputs);

Request parameters

A value outside these lists is refused with a 400 naming the field, before anything is charged. Nothing is quietly rounded or dropped.

Inputs

Cite an input in the prompt by type and order (@image1, @video1, @audio1), or give it a name and cite @name. An input outside these limits is refused with a 400 naming it, before anything is charged.

2. Authentication

API key

Create a key on Keys with the generate and spend scopes and send it as a bearer token. Keep it on your server; never send it to a browser.

Authorization: Bearer $ELYUM_API_KEY

3. Queue

Submit and wait

With Prefer: wait=55 the request holds until the render ends or 55 seconds pass. A finished render answers 200 with its outputs; one still running answers 202 with its id.

Poll and cancel

const headers = { Authorization: `Bearer ${process.env.ELYUM_API_KEY}` }; // Poll until the render ends: succeeded, failed or canceledlet generation = await (await fetch(`https://api.elyum.ai/v1/generations/${id}`, { headers })).json();while (generation.status === "queued" || generation.status === "running") {  await new Promise((r) => setTimeout(r, 5000));  generation = await (await fetch(`https://api.elyum.ai/v1/generations/${id}`, { headers })).json();} // Or stop it (a hold is refunded)await fetch(`https://api.elyum.ai/v1/generations/${id}/cancel`, { method: "POST", headers });

Output links are signed and last 24 hours: download them to your own storage, or fetch the generation again for fresh ones.

4. Pricing

Send ?dry_run=true for the exact price of a request with nothing held. The API spends your API balance; a render that fails or is canceled costs nothing.