Quickstart

curl https://api.samsa.ai/public/v1/me \
  -H "Authorization: Bearer $SAMSA_API_KEY"

import os
import requests

BASE_URL = "https://api.samsa.ai/public/v1"
API_KEY = os.environ["SAMSA_API_KEY"]
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(f"{BASE_URL}/me", headers=HEADERS)
resp.raise_for_status()
print(resp.json())

const BASE_URL = "https://api.samsa.ai/public/v1";
const API_KEY = process.env.SAMSA_API_KEY!;
const headers = { Authorization: `Bearer ${API_KEY}` };

const resp = await fetch(`${BASE_URL}/me`, { headers });
if (!resp.ok) throw new Error(`GET /me failed: ${resp.status}`);
console.log(await resp.json());

curl -X POST https://api.samsa.ai/public/v1/images/generations \
  -H "Authorization: Bearer $SAMSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A minimalist product shot of a ceramic mug on linen, soft daylight",
    "style_id": "2b9d1f7a-3c4e-4a5b-9c8d-0e1f2a3b4c5d",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_outputs": 1
  }'

payload = {
    "prompt": "A minimalist product shot of a ceramic mug on linen, soft daylight",
    "style_id": "2b9d1f7a-3c4e-4a5b-9c8d-0e1f2a3b4c5d",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_outputs": 1,
}

resp = requests.post(
    f"{BASE_URL}/images/generations",
    headers={**HEADERS, "Content-Type": "application/json"},
    json=payload,
)
resp.raise_for_status()
job = resp.json()
generation_id = job["id"]
print(job)

const payload = {
  prompt: "A minimalist product shot of a ceramic mug on linen, soft daylight",
  style_id: "2b9d1f7a-3c4e-4a5b-9c8d-0e1f2a3b4c5d",
  aspect_ratio: "1:1",
  resolution: "1K",
  num_outputs: 1,
};

const submit = await fetch(`${BASE_URL}/images/generations`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
if (!submit.ok) throw new Error(`generation failed: ${submit.status}`);
const job = await submit.json();
const generationId = job.id;
console.log(job);

curl https://api.samsa.ai/public/v1/images/generations/7f9c0e2a-1b3d-4c5e-8f6a-9b0c1d2e3f40 \
  -H "Authorization: Bearer $SAMSA_API_KEY"

import time

while True:
    resp = requests.get(
        f"{BASE_URL}/images/generations/{generation_id}",
        headers=HEADERS,
    )
    resp.raise_for_status()
    result = resp.json()
    if result["status"] in ("completed", "failed", "cancelled"):
        break
    time.sleep(2)

print(result)

async function poll(id: string) {
  while (true) {
    const resp = await fetch(`${BASE_URL}/images/generations/${id}`, { headers });
    if (!resp.ok) throw new Error(`poll failed: ${resp.status}`);
    const result = await resp.json();
    if (["completed", "failed", "cancelled"].includes(result.status)) {
      return result;
    }
    await new Promise((r) => setTimeout(r, 2000));
  }
}

const result = await poll(generationId);
console.log(result);

curl -o mug.png \
  "https://cdn.samsa.ai/user-.../7f9c0e2a.png?X-Amz-Signature=..."

image_url = result["images"][0]["url"]
img = requests.get(image_url)
img.raise_for_status()
with open("mug.png", "wb") as f:
    f.write(img.content)

const imageUrl = result.images[0].url;
const img = await fetch(imageUrl);
const buffer = Buffer.from(await img.arrayBuffer());
await import("node:fs/promises").then((fs) => fs.writeFile("mug.png", buffer));