Unstructured API
Hosted document ETL that partitions PDFs, Office files and images into structured elements for RAG.
- Provider
- default
- Kind
- Worker
- Category
- Compute
- Official docs
- https://docs.unstructured.io/api-reference/overview
- Also known as
- Unstructured Platform
| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| accelerator | enum | none | gpu | asic | no | none | inherited |
| concurrency | integer | — | no | — | inherited |
| deployment | enum | shared-saas | dedicated | in-vpc | no | shared-saas | inherited |
| fanoutStrategy | enum | none | push | pull | hybrid | no | none | inherited |
| fanoutThreshold | integer | — | no | — | inherited |
| idempotent | boolean | — | no | false | ▸ false |
| instances | integer | — | no | — | inherited |
| managed | boolean | — | no | false | ▸ true |
| plan | enum | lets-go | pay-as-you-go | business | no | pay-as-you-go | inherited |
| rateControl | enum | none | fixed | aimd | no | none | inherited |
| schedule | string | — | no | — | inherited |
| trigger | enum | queue | stream | schedule | batch | manual | yes | — | ▸ queue |
| workflowPipelines | boolean | — | no | false | inherited |
Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.
Pure push fan-out over a social graph is brutal at the tail: one post from an account with millions of followers becomes millions of cache writes. A follower threshold above which readers merge at read time bounds that write amplification.
- — all of these hold:
- — the node's `fanoutStrategy` is "push"
- — the node's `fanoutThreshold` has no value
- — the design contains a node of kind graph-database
One worker pool consuming several queues lets a slow or poisoned queue starve the others. That is precisely what the design's per-queue isolation requirement forbids.
- — all of these hold:
- — the node has more than 1 incoming edge from a queue
- — the design requirement `isolation.perQueue` is true
A stateful compute node pinned to exactly one availability zone disappears with that zone, and its state goes with it. Nodes inside a cell are exempt, because there the cell is deliberately single-zone and redundancy comes from the other cells.
- — all of these hold:
- — the node's `stateless` is false
- — the node sits inside exactly 1 availability-zone group
- — this does not hold:
- — the node sits inside at least one cell group
nodes:
- { id: "unstructured-io", component: "unstructured-io" }# yaml-language-server: $schema=../../schema/component.schema.json # Unstructured API: hosted document ETL that partitions PDFs, Office files and images into structured elements for RAG. # Per "Unstructured API developer guide", Let's Go and Pay-As-You-Go run on shared SaaS while Business adds a dedicated # instance or an in-VPC install; billing is per page, and the pricing page makes the first 10,000 pages free. schemaVersion: "1" type: "component" id: "unstructured-io" kind: "worker" provider: "default" docs: "https://docs.unstructured.io/api-reference/overview" aliases: ["Unstructured API", "Unstructured Platform"] defaults: managed: true trigger: "queue" idempotent: false properties: plan: type: "enum" values: ["lets-go", "pay-as-you-go", "business"] default: "pay-as-you-go" deployment: type: "enum" values: ["shared-saas", "dedicated", "in-vpc"] default: "shared-saas" workflowPipelines: type: "boolean" default: false