Quickstart

# Needs curl, jq and uuidgen.
API=https://api.voyager.so/v1
AUTH="Authorization: Bearer $VOYAGER_API_KEY"

# 1. Create
JOB_ID=$(curl -sf "$API/jobs" \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "nano-banana-2.1", "operation": "text-to-image", "input": {"prompt": "a red fox in snow", "aspect_ratio": "16:9"}}' \
  | jq -r .id)
echo "created $JOB_ID"

# 2. Wait
while :; do
  JOB=$(curl -sf "$API/jobs/$JOB_ID?wait=25" -H "$AUTH")
  STATUS=$(echo "$JOB" | jq -r .status)
  [ "$STATUS" = queued ] || [ "$STATUS" = running ] || break
done
echo "status: $STATUS"
[ "$STATUS" = succeeded ] || { echo "$JOB" | jq .error; exit 1; }

# 3. Download
curl -sf -o fox.png "$(echo "$JOB" | jq -r '.outputs[0].url')"
echo "$JOB" | jq .credits

# pip install requests
import os
import time
import uuid

import requests

API = "https://api.voyager.so/v1"
AUTH = {"Authorization": f"Bearer {os.environ['VOYAGER_API_KEY']}"}

# 1. Create
response = requests.post(
    f"{API}/jobs",
    headers={**AUTH, "Idempotency-Key": str(uuid.uuid4())},
    json={"model": "nano-banana-2.1", "operation": "text-to-image", "input": {"prompt": "a red fox in snow", "aspect_ratio": "16:9"}},
    timeout=30,
)
response.raise_for_status()
job = response.json()
print("created", job["id"])

# 2. Wait
while job["status"] in ("queued", "running"):
    response = requests.get(f"{API}/jobs/{job['id']}", headers=AUTH, params={"wait": 25}, timeout=60)
    response.raise_for_status()
    job = response.json()
    if job["status"] in ("queued", "running") and job.get("poll_after_ms"):
        time.sleep(job["poll_after_ms"] / 1000)

if job["status"] != "succeeded":
    raise SystemExit(f"{job['status']}: {job['error']}")

# 3. Download
output = job["outputs"][0]
extension = output["mime_type"].split("/")[-1]
download = requests.get(output["url"], timeout=120)
download.raise_for_status()  # fails on an expired link: GET the job again for a fresh URL
with open(f"fox.{extension}", "wb") as file:
    file.write(download.content)

print("saved", f"fox.{extension}", "credits", job["credits"])

// Node 18+; save as quickstart.mjs and run: node quickstart.mjs
import { randomUUID } from "node:crypto";
import { writeFile } from "node:fs/promises";

const API = "https://api.voyager.so/v1";
const AUTH = { Authorization: `Bearer ${process.env.VOYAGER_API_KEY}` };

async function call(path, init = {}) {
  const response = await fetch(`${API}${path}`, { ...init, headers: { ...AUTH, ...init.headers } });
  const body = await response.json();
  if (!response.ok) throw new Error(`${response.status} ${body.error?.code}: ${body.error?.message}`);
  return body;
}

// 1. Create
let job = await call("/jobs", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Idempotency-Key": randomUUID() },
  body: JSON.stringify({
    model: "nano-banana-2.1",
    operation: "text-to-image",
    input: { prompt: "a red fox in snow", aspect_ratio: "16:9" },
  }),
});
console.log("created", job.id);

// 2. Wait
while (job.status === "queued" || job.status === "running") {
  job = await call(`/jobs/${job.id}?wait=25`);
  if ((job.status === "queued" || job.status === "running") && job.poll_after_ms) {
    await new Promise((resolve) => setTimeout(resolve, job.poll_after_ms));
  }
}
if (job.status !== "succeeded") throw new Error(`${job.status}: ${JSON.stringify(job.error)}`);

// 3. Download
const output = job.outputs[0];
const file = `fox.${output.mime_type.split("/")[1]}`;
const download = await fetch(output.url);
// Fails on an expired link: GET the job again for a fresh URL.
if (!download.ok) throw new Error(`download failed: ${download.status}`);
await writeFile(file, Buffer.from(await download.arrayBuffer()));
console.log("saved", file, "credits", job.credits);