Extraction pipelines

Scope: pipelines apply to extraction tables and the extraction API only. The reconcile-table agent does not use pipelines — it uses model tiers (Fast / Balanced / Powerful), configured per table under AI Model. See the agent runtime. The two sets of names are not interchangeable.

A pipeline is the AI model configuration used for an extraction run. You set a default pipeline per extraction table via the settings API, and it applies to every run on that table unless overridden.

Comparison

Pipeline	Speed	Accuracy	Best for
`cloudsquid-flash`	Fastest	Good	High-volume, cost-sensitive, simple schemas
`cloudsquid-flash-v3`	Fast	Better	Default starting point — good balance of speed and quality
`cloudsquid-pro-v2`	Slower (10–30s)	High	Complex documents, nested schemas
`cloudsquid-pro-v3`	Slower	Highest	Dense or visually complex layouts, highest accuracy requirements

Start with cloudsquid-flash-v3 for all new tables. Switch to cloudsquid-pro-v3 only if accuracy on complex document layouts is insufficient.

Bounding boxes

Enabling bounding_boxes adds source-location metadata to each extracted value — a reference back to the exact position in the original document. Useful for auditability and human review workflows, but increases processing time regardless of pipeline.

How to set a pipeline

Use the extraction settings endpoint to update a table’s active pipeline.

import requests

requests.patch(
    "https://api.cloudsquid.io/api/projects/my-project/tables/TABLE_ID/extraction-settings",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "active_pipeline": "cloudsquid-flash-v3",
        "bounding_boxes": False,
        "review_mode": False
    }
)

curl -X PATCH \
  "https://api.cloudsquid.io/api/projects/my-project/tables/TABLE_ID/extraction-settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active_pipeline": "cloudsquid-flash-v3", "bounding_boxes": false, "review_mode": false}'

Tables

How reconcile, storage, and extraction tables work together.

Async run pattern

The three-step upload → start → poll flow.

The agent runtime

Model tiers for the reconcile-table agent — a different subsystem.

Quickstart: extraction

Set up an extraction table end to end.

Getting started

Core concepts

Cookbooks

More guides

Comparison

Bounding boxes

How to set a pipeline

Tables

Async run pattern

The agent runtime

Quickstart: extraction

​Comparison

​Bounding boxes

​How to set a pipeline

Tables

Async run pattern

The agent runtime

Quickstart: extraction

Comparison

Bounding boxes

How to set a pipeline