Set Up Your Extend Account

Follow these steps to get an Extend account running alongside your existing Chunkr integration. You can keep both live while you validate.

Create an account and API key

Sign up at extend.ai
Open the Developers page in the dashboard
Create an API key and store it as EXTEND_API_KEY

export EXTEND_API_KEY="sk_..."

Extend offers test-mode keys that route to an isolated environment with no production data or webhooks. Use one while you migrate, then switch the key for production. See the test environment guide.

Install the SDK

pip install extend-ai

npm install extend-ai

Extend also ships Java and Go SDKs and an extend CLI.

Make your first call

The Chunkr quickstart created a parse task and polled for it. On Extend, create_and_poll does both in one call.

from extend_ai import Extend

# Reads EXTEND_API_KEY from the environment
client = Extend()

run = client.parse_runs.create_and_poll(
    file={"url": "https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf"}
)

print(run.status)  # "PROCESSED"
for chunk in run.output.chunks:
    print(chunk.content[:200])

import { ExtendClient } from "extend-ai";

// Reads EXTEND_API_KEY from the environment
const client = new ExtendClient();

const run = await client.parseRuns.createAndPoll({
  file: { url: "https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf" },
});

console.log(run.status); // "PROCESSED"
for (const chunk of run.output?.chunks ?? []) {
  console.log(chunk.content.slice(0, 200));
}

Compare with your Chunkr output

Run the same document through both APIs and compare the markdown. The structure differs (see Migrating Parse) but the content should be equivalent. If something looks off, Extend’s Studio lets you inspect the run visually and tweak configuration before copying it into code.

Side by side

Here is the Chunkr quickstart next to its Extend equivalent.

import os
import time
from chunkr_ai import Chunkr

client = Chunkr(api_key=os.environ["CHUNKR_API_KEY"])

task = client.tasks.parse.create(
    file="https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf"
)

while not task.completed:
    task = client.tasks.parse.get(task_id=task.task_id)
    time.sleep(3)

if task.status == "Succeeded":
    for chunk in task.output.chunks:
        print(chunk.embed)

from extend_ai import Extend

client = Extend()

run = client.parse_runs.create_and_poll(
    file={"url": "https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf"}
)

if run.status == "PROCESSED":
    for chunk in run.output.chunks:
        print(chunk.content)

Synchronous calls for quick tests

Extend also exposes synchronous endpoints that block until the result is ready. They have a hard 5-minute timeout, so use them for testing and small files, and async runs for production.

run = client.parse(
    file={"url": "https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf"}
)

const run = await client.parse({
  file: { url: "https://s3.us-east-1.amazonaws.com/chunkr-web/uploads/invoice.pdf" },
});

Overview

Migration Guide

Reference

Set Up Your Extend Account

Side by side

Next Steps

Migrating Parse

Migrating Extract

​Side by side

​Next Steps

Migrating Parse

Migrating Extract

Side by side

Next Steps