Quickstart

pip install flexorch-sdk

import os
from flexorch_sdk import FlexOrchClient

client = FlexOrchClient(os.environ["FLEXORCH_API_KEY"])

job = client.process("invoice.pdf")
print(job.id)  # 1234

result = job.wait(timeout=120)

print(result.status)         # "completed"
print(result.quality_grade)  # "A"
print(result.quality_score)  # 0.91
print(result.degraded)       # False — True if structured extraction
                              # partially failed but the job still succeeded

dataset = result.build_dataset().wait().dataset()

# Export as JSONL for fine-tuning
dataset.export("jsonl", path="./output.jsonl")

# Or export as Parquet for analytics
dataset.export("parquet", path="./output.parquet")

npm install flexorch-sdk

import { FlexOrchClient } from 'flexorch-sdk';

const client = new FlexOrchClient(process.env.FLEXORCH_API_KEY);

const job = await client.process('invoice.pdf');
const result = await job.wait({ timeout: 120 });  // seconds

console.log(result.qualityGrade);  // "A"
console.log(result.qualityScore);  // 0.91

import * as fs from 'node:fs/promises';

const built = await result.buildDataset();
const dataset = await (await built.wait()).dataset();

const bytes = await dataset.export('jsonl');
await fs.writeFile('./output.jsonl', bytes);

curl -X POST https://api.flexorch.com/v1/data-process/async \
  -H "X-API-KEY: dfx_your_key_here" \
  -F "files=@invoice.pdf"

{
  "status": "accepted",
  "data": {
    "accepted": 1,
    "rejected": [],
    "jobs": [{ "filename": "invoice.pdf", "job_id": 1234, "status": "queued" }]
  },
  "error": null,
  "meta": { "poll": "/v1/jobs/1234" }
}

curl https://api.flexorch.com/v1/jobs/1234 \
  -H "X-API-KEY: dfx_your_key_here"

# Build — execution_id comes from the completed job's processing_summary
curl -X POST https://api.flexorch.com/v1/datasets/build-from-execution/{execution_id} \
  -H "X-API-KEY: dfx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-dataset"}'

# Poll the returned dataset_build job_id the same way as step 2, then export.
# fmt is a path segment (json | jsonl | csv | parquet | md | xml | xlsx | rag | hf):
curl https://api.flexorch.com/v1/datasets/{dataset_id}/export/jsonl \
  -H "X-API-KEY: dfx_your_key_here" \
  -o output.jsonl