Quickstart

Open Resources and choose Add a resource. Pick Text, give it a title such as “Refund policy”, and paste a few paragraphs. Markdown headings (#) become the sections an answer cites.

The resource shows Indexing for a few seconds, then Ready.

Open Assistants and choose Create an assistant. Name it, then open it and choose what it answers from: all resources, the ones you pick, or a tag. In the first case there is nothing else to set.

Open Chat, pick the assistant and ask something your text answers. The answer cites its sources as [1], [2]. Open a citation to read the passage it relies on.

In the app, open Developer tools, then the API tab, and choose Create key. Pick the Editor preset: it can read, add and update resources and assistants, and ask questions. Copy the key now. Lookio shows it once.

export LOOKIO_API_KEY="sk_live_..."

curl https://api.lookio.app/v1/account \
  -H "Authorization: Bearer $LOOKIO_API_KEY"

The response lists the scopes this key holds.

curl https://api.lookio.app/v1/resources \
  -H "Authorization: Bearer $LOOKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "title": "Refund policy",
    "text": "# Refunds\n\nYou can return any item within 30 days for a full refund."
  }'

The resource comes back with status set to queued. Note its data.id.

curl https://api.lookio.app/v1/resources/RESOURCE_ID \
  -H "Authorization: Bearer $LOOKIO_API_KEY"

Repeat until data.status is ready. If it is failed, read data.status_detail.

curl https://api.lookio.app/v1/assistants \
  -H "Authorization: Bearer $LOOKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support",
    "context": "You are the support assistant of Acme. You answer customers who want a quick, accurate reply.",
    "resource_ids": ["RESOURCE_ID"]
  }'

Note the assistant’s data.id.

curl https://api.lookio.app/v1/assistants/ASSISTANT_ID/query \
  -H "Authorization: Bearer $LOOKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "question": "How long do I have to return an item?" }'

data.answer holds the answer, data.citations the passages behind it, and data.credit_cost what it cost. The default mode is Flash, 30 credits.