Async Image Processing

export AD_API_KEY="sk_..."
export AD_API_BASE_URL="https://api.animaldetect.com/v1"
export IMAGE_PATH="/path/to/img_001.jpg"

curl -sS -X POST "$AD_API_BASE_URL/jobs" \
  -H "Authorization: Bearer $AD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: camera-a-img-001" \
  -d '{
    "operation": "detect",
    "filename": "img_001.jpg",
    "content_type": "image/jpeg",
    "client_reference_id": "camera-a/2026-06-17/img_001",
    "options": { "threshold": 0.2, "classify": true }
  }' > job.json

UPLOAD_URL="$(jq -r '.upload.url' job.json)"
SUBMIT_URL="$(jq -r '.submit_url' job.json)"
STATUS_URL="$(jq -r '.status_url' job.json)"
RESULT_URL="$(jq -r '.result_url' job.json)"

curl -sS -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --upload-file "$IMAGE_PATH"

curl -sS -X POST "$SUBMIT_URL" \
  -H "Authorization: Bearer $AD_API_KEY"

curl -sS "$STATUS_URL" \
  -H "Authorization: Bearer $AD_API_KEY"

curl -sS "$RESULT_URL" \
  -H "Authorization: Bearer $AD_API_KEY"

const apiKey = process.env.ANIMAL_DETECT_API_KEY
const baseUrl = 'https://api.animaldetect.com/v1'
const imageFile = new File([imageBytes], 'img_001.jpg', { type: 'image/jpeg' })

const createResponse = await fetch(baseUrl + '/jobs', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'camera-a-img-001',
  },
  body: JSON.stringify({
    operation: 'detect',
    filename: imageFile.name,
    content_type: imageFile.type,
    expected_size_bytes: imageFile.size,
    client_reference_id: 'camera-a/2026-06-17/img_001',
    options: {
      threshold: 0.2,
      classify: true,
    },
  }),
})

const job = await createResponse.json()

await fetch(job.upload.url, {
  method: job.upload.method,
  headers: {
    ...job.upload.headers,
    'Content-Type': imageFile.type,
  },
  body: imageFile,
})

await fetch(job.submit_url, {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
  },
})

let status
do {
  await new Promise((resolve) => setTimeout(resolve, 2000))
  const statusResponse = await fetch(job.status_url, {
    headers: { Authorization: 'Bearer ' + apiKey },
  })
  status = await statusResponse.json()
} while (status.status === 'queued' || status.status === 'running')

if (status.status !== 'succeeded') {
  throw new Error(status.error?.message ?? 'Async job failed')
}

const resultResponse = await fetch(job.result_url, {
  headers: { Authorization: 'Bearer ' + apiKey },
})
const result = await resultResponse.json()

{
  "job_id": "5fd3825f-46a3-4892-8600-44a319e2d18f",
  "status": "awaiting_upload",
  "operation": "detect",
  "client_reference_id": "camera-a/2026-06-17/img_001",
  "upload": {
    "method": "PUT",
    "url": "https://storage.googleapis.com/animal_detect_prod/users/...",
    "headers": {
      "Content-Type": "image/jpeg"
    },
    "expires_at": "2026-06-17T13:15:00.000Z"
  },
  "submit_url": "https://api.animaldetect.com/v1/jobs/5fd3825f-46a3-4892-8600-44a319e2d18f/submit",
  "status_url": "https://api.animaldetect.com/v1/jobs/5fd3825f-46a3-4892-8600-44a319e2d18f",
  "result_url": "https://api.animaldetect.com/v1/jobs/5fd3825f-46a3-4892-8600-44a319e2d18f/result",
  "expires_at": "2026-07-17T13:00:00.000Z"
}