Summer API quickstart: your first 3D model

npx -y summer-engine@latest api estimate 3d/default \
  --input '{"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"}'

curl https://www.summerengine.com/v1/estimate \
  -H "Content-Type: application/json" \
  -d '{"model": "3d/default", "input": {"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"}}'

npx -y summer-engine@latest api run 3d/default \
  --input '{"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"}' \
  --download .

# Needs curl and jq.
API=https://www.summerengine.com/v1
AUTH="Authorization: Bearer $SUMMER_TOKEN"

JOB=$(curl -s $API/jobs -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" -H "Prefer: wait=60" \
  -d '{"model": "3d/default", "input": {"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"}}')
echo "$JOB" | jq -e .job > /dev/null || { echo "$JOB"; exit 1; }
ID=$(echo "$JOB" | jq -r .job.id)

while true; do
  JOB=$(curl -s "$API/jobs/$ID" -H "$AUTH")
  echo "$JOB" | jq -e .job > /dev/null || { echo "$JOB"; exit 1; }
  STATE=$(echo "$JOB" | jq -r .job.state)
  [ "$STATE" = queued ] || [ "$STATE" = running ] || break
  sleep "$(echo "$JOB" | jq -r '.job.pollAfterSeconds // 5')"
done
[ "$STATE" = done ] || { echo "$JOB"; exit 1; }

URL=$(echo "$JOB" | jq -r '.job.result.assets[0].fileUrl')
curl -fsL "$URL" -o chest.glb && echo "Saved chest.glb"

// make-chest.ts. Run with Node 22: npx tsx make-chest.ts
import { writeFile } from "node:fs/promises";

const API = "https://www.summerengine.com/v1";
const auth = { Authorization: `Bearer ${process.env.SUMMER_TOKEN}` };

const res = await fetch(`${API}/jobs`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), Prefer: "wait=60" },
  body: JSON.stringify({
    model: "3d/default",
    input: { kind: "text-to-3d", prompt: "a stylized treasure chest, game prop" },
  }),
});
const started = await res.json();
if (started.error) throw new Error(`${started.error.code}: ${started.error.message}`);
let job = started.job;
console.log(`Job ${job.id}, estimated ${job.estimatedPrice} USD`);

while (job.state === "queued" || job.state === "running") {
  await new Promise((done) => setTimeout(done, (job.pollAfterSeconds ?? 5) * 1000));
  const read = await (await fetch(`${API}/jobs/${job.id}`, { headers: auth })).json();
  if (read.error) throw new Error(`${read.error.code}: ${read.error.message}`);
  job = read.job;
}
if (job.state !== "done") throw new Error(`The job ended ${job.state}: ${job.error?.message ?? ""}`);

const asset = job.result.assets[0];
const file = await fetch(asset.fileUrl);
if (!file.ok) throw new Error(`Download failed: ${file.status}`);
await writeFile("chest.glb", Buffer.from(await file.arrayBuffer()));
console.log(`Saved chest.glb (Summer asset ${asset.assetId})`);

# make_chest.py. Needs: pip install requests
import os, time, uuid, requests

API = "https://www.summerengine.com/v1"
auth = {"Authorization": f"Bearer {os.environ['SUMMER_TOKEN']}"}

started = requests.post(
    f"{API}/jobs",
    headers={**auth, "Idempotency-Key": str(uuid.uuid4()), "Prefer": "wait=60"},
    json={
        "model": "3d/default",
        "input": {"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"},
    },
).json()
if "error" in started:
    raise SystemExit(f"{started['error']['code']}: {started['error']['message']}")
job = started["job"]
print(f"Job {job['id']}, estimated {job['estimatedPrice']} USD")

while job["state"] in ("queued", "running"):
    time.sleep(job.get("pollAfterSeconds", 5))
    read = requests.get(f"{API}/jobs/{job['id']}", headers=auth).json()
    if "error" in read:
        raise SystemExit(f"{read['error']['code']}: {read['error']['message']}")
    job = read["job"]
if job["state"] != "done":
    raise SystemExit(f"The job ended {job['state']}: {job.get('error')}")

asset = job["result"]["assets"][0]
file = requests.get(asset["fileUrl"])
file.raise_for_status()
with open("chest.glb", "wb") as f:
    f.write(file.content)
print(f"Saved chest.glb (Summer asset {asset['assetId']})")