SDKs

The official SateAIs SDKs wrap the REST API with a typed client, automatic credential resolution, and a built-in polling helper that waits for a job to finish. They share the same method shape across languages, so examples translate one-to-one.

Choose your language

Installation at a glance

pip install sateais

from sateais import Client

client = Client()  # reads SATEAIS_API_KEY
job = client.analyze.ship(scene_id="S1A_IW_GRDH_...")
result = client.jobs.wait(job.job_id)  # poll until completed
print(len(result["features"]), "ships detected")

npm install @sateais/sdk

import { Client } from "@sateais/sdk";

const client = new Client(); // reads SATEAIS_API_KEY
const job = await client.analyze.ship({ scene_id: "S1A_IW_GRDH_..." });
const result = await client.jobs.wait(job.job_id); // poll until completed
console.log(result.features.length, "ships detected");

What the SDKs handle for you

• Authentication — resolve the API key from an argument or the SATEAIS_API_KEY environment variable.
• Typed methods — one method per detection type under client.analyze, plus client.jobs for status and results.
• Polling — jobs.wait() polls until the job completes and returns the GeoJSON, raising a typed error on failure or timeout.
• Errors — HTTP and job failures are mapped to typed exception classes that mirror the API error codes.

Next steps