客户 SDK（JavaScript / Python）

sdk/examples/quickstart.mjs

// Node.js 22+. Run from the repository root: node sdk/examples/quickstart.mjs
// Reads ORBIT_SIM_BASE_URL and ORBIT_SIM_API_KEY. Keep the key on your server; never log it.
import { OrbitClient, OrbitError } from '../js/orbit-sim.mjs';

const orbit = new OrbitClient({ baseUrl: process.env.ORBIT_SIM_BASE_URL, apiKey: process.env.ORBIT_SIM_API_KEY });

const { models } = await orbit.models();
console.log('models:', models.map(m => m.id).join(', '));

// requestId is the idempotency key. Save it before sending.
const requestId = process.env.ORBIT_SIM_REQUEST_ID || crypto.randomUUID();
try {
  const { replayed, record } = await orbit.generate({ model: 'sim-general', message: 'hello', maxOutputTokens: 64, requestId });
  console.log('generate:', record.state, 'cost', record.cost, 'replayed', replayed);
} catch (error) {
  if (!(error instanceof OrbitError) || !error.outcomeUnknown) throw error;
  // The SDK never re-sends a POST whose outcome is unknown. Check the same requestId instead.
  const check = await orbit.lookup(error.requestId);
  console.log('unknown outcome:', error.code ?? error.name, 'lookup', check.state);
}

const check = await orbit.lookup(requestId);
console.log('lookup:', check.state);

sdk/examples/quickstart.py

# Python 3.9+. Run from the repository root: python3 sdk/examples/quickstart.py
# Reads ORBIT_SIM_BASE_URL and ORBIT_SIM_API_KEY. Keep the key on your server; never log it.
import os
import sys
import uuid

sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "python"))
import orbit_sim  # noqa: E402

orbit = orbit_sim.OrbitClient(os.environ["ORBIT_SIM_BASE_URL"], os.environ["ORBIT_SIM_API_KEY"])

models = orbit.models()["models"]
print("models:", ", ".join(m["id"] for m in models))

# request_id is the idempotency key. Save it before sending.
request_id = os.environ.get("ORBIT_SIM_REQUEST_ID") or str(uuid.uuid4())
try:
    ack = orbit.generate("sim-general", "hello", 64, request_id=request_id)
    print("generate:", ack["record"]["state"], "cost", ack["record"]["cost"], "replayed", str(ack["replayed"]).lower())
except orbit_sim.OrbitError as error:
    if not error.outcome_unknown:
        raise
    # The SDK never re-sends a POST whose outcome is unknown. Check the same request_id instead.
    check = orbit.lookup(error.request_id)
    print("unknown outcome:", error.code or type(error).__name__, "lookup", check["state"])

print("lookup:", orbit.lookup(request_id)["state"])

export ORBIT_SIM_BASE_URL=... ORBIT_SIM_API_KEY=...
node sdk/examples/quickstart.mjs

export ORBIT_SIM_BASE_URL=... ORBIT_SIM_API_KEY=...
python3 sdk/examples/quickstart.py

sdk/examples/stream.mjs

// Node.js 22+. Run from the repository root: node sdk/examples/stream.mjs
// Reads ORBIT_SIM_BASE_URL and ORBIT_SIM_API_KEY. Keep the key on your server; never log it.
import { OrbitClient } from '../js/orbit-sim.mjs';

const orbit = new OrbitClient({ baseUrl: process.env.ORBIT_SIM_BASE_URL, apiKey: process.env.ORBIT_SIM_API_KEY });
const requestId = process.env.ORBIT_SIM_REQUEST_ID || crypto.randomUUID();

// Delta text is provisional. The record is final only when stream() resolves.
const result = await orbit.stream(
  { model: 'sim-general', message: 'hello', maxOutputTokens: 64, requestId },
  { onFrame: frame => { if (frame.type === 'delta') process.stdout.write(frame.text); } },
);
console.log();
console.log('stream:', result.record.state, 'cost', result.record.cost, 'replayed', result.replayed);

sdk/examples/stream.py

# Python 3.9+. Run from the repository root: python3 sdk/examples/stream.py
# Reads ORBIT_SIM_BASE_URL and ORBIT_SIM_API_KEY. Keep the key on your server; never log it.
import os
import sys
import uuid

sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "python"))
import orbit_sim  # noqa: E402

orbit = orbit_sim.OrbitClient(os.environ["ORBIT_SIM_BASE_URL"], os.environ["ORBIT_SIM_API_KEY"])
request_id = os.environ.get("ORBIT_SIM_REQUEST_ID") or str(uuid.uuid4())


def show(frame):
    # Delta text is provisional. The record is final only when stream() returns.
    if frame["type"] == "delta":
        print(frame["text"], end="", flush=True)


result = orbit.stream("sim-general", "hello", 64, request_id=request_id, on_frame=show)
print()
print("stream:", result["record"]["state"], "cost", result["record"]["cost"], "replayed", str(result["replayed"]).lower())