The D8alytics API.

BASE="https://api.d8alytics.com/v1"
KEY="d8_live_YOUR_KEY"
AUTH="Authorization: Bearer $KEY"

# 1) start a job                                    (needs curl and jq)
JOB=$(curl -s -X POST "$BASE/jobs" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"name":"PPE detection","parameters":{
        "prompt":"workers on a construction site, CCTV angle",
        "classes":["person","hard hat","safety vest"],
        "num_images":6}}' | jq -r .job_id)
echo "Job started: $JOB"

# 2) wait until it is finished (checks every 15 seconds)
while true; do
  S=$(curl -s "$BASE/jobs/$JOB" -H "$AUTH")
  echo "$(echo "$S" | jq -r .status)  $(echo "$S" | jq -r .progress)%"
  case "$(echo "$S" | jq -r .status)" in completed|failed|cancelled) break;; esac
  sleep 15
done

# 3) get the download link and save the ZIP
DS=$(echo "$S" | jq -r .dataset_id)
URL=$(curl -s "$BASE/datasets/$DS/download" -H "$AUTH" | jq -r .url)
curl -sL "$URL" -o dataset.zip

# pip install requests
import time, requests

BASE = "https://api.d8alytics.com/v1"
KEY  = "d8_live_YOUR_KEY"
H    = {"Authorization": f"Bearer {KEY}"}

# 1) start a job
job = requests.post(f"{BASE}/jobs", headers=H, json={
    "name": "PPE detection",
    "parameters": {
        "prompt": "workers on a construction site, CCTV angle",
        "classes": ["person", "hard hat", "safety vest"],
        "num_images": 6,
    },
}).json()
print("Job started:", job["job_id"])

# 2) wait until it is finished (checks every 15 seconds)
while True:
    s = requests.get(f"{BASE}/jobs/{job['job_id']}", headers=H).json()
    print(s["status"], s["progress"], "%")
    if s["status"] in ("completed", "failed", "cancelled"):
        break
    time.sleep(15)

# 3) get the download link and save the ZIP
url = requests.get(f"{BASE}/datasets/{s['dataset_id']}/download", headers=H).json()["url"]
with open("dataset.zip", "wb") as f:
    f.write(requests.get(url).content)

curl https://api.d8alytics.com/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

r = requests.get("https://api.d8alytics.com/v1/me",
                 headers={"Authorization": "Bearer YOUR_API_KEY"})
print(r.json())

curl -X POST https://api.d8alytics.com/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "PPE detection",
    "parameters": {
      "prompt": "workers on a construction site, CCTV angle",
      "classes": ["person", "hard hat", "safety vest"],
      "label_guide": "hard hat: box only the helmet, not the head.",
      "num_images": 6,
      "image_size": 1024,
      "augment_copies": 0
    }
  }'

import requests

r = requests.post("https://api.d8alytics.com/v1/jobs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "name": "PPE detection",
        "parameters": {
            "prompt": "workers on a construction site, CCTV angle",
            "classes": ["person", "hard hat", "safety vest"],
            "label_guide": "hard hat: box only the helmet, not the head.",
            "num_images": 6,
            "image_size": 1024,
            "augment_copies": 0,
        },
    })
print(r.json())

curl https://api.d8alytics.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

r = requests.get("https://api.d8alytics.com/v1/jobs/JOB_ID",
                 headers={"Authorization": "Bearer YOUR_API_KEY"})
print(r.json())

URL=$(curl -s https://api.d8alytics.com/v1/datasets/DATASET_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" | jq -r .url)

# then save the file
curl -sL "$URL" -o dataset.zip

import requests

url = requests.get("https://api.d8alytics.com/v1/datasets/DATASET_ID/download",
                   headers={"Authorization": "Bearer YOUR_API_KEY"}).json()["url"]

# then save the file
with open("dataset.zip", "wb") as f:
    f.write(requests.get(url).content)