Tasks

Image and audio finish inside the call. Video does not, and that is the only reason this page exists.

Waiting

ts
const handle = await sequel.run({ model: 'google/veo-3.1', prompt: '…' });

handle.task.status;  // 'in_progress'
const done = await handle.wait({ timeout: 300_000 });

wait polls with backoff, starting at a second and settling at five. It is for scripts and notebooks — in production take the webhook instead, so nothing is holding a connection open for three minutes.

Fetching and listing

ts
await sequel.tasks.get('task_1d212b8a6ca24206b2e7');

await sequel.tasks.list({
  status: ['completed'],
  models: ['black-forest-labs/flux-1-schnell'],
});

Lists are scoped to the organisation your credential belongs to — never to a parameter, so no key can read another team’s runs.

Webhooks

Register one in Settings → Webhooks. Completed and failed tasks are posted as an event with a signature over the body:

json
{
  "id": "evt_…",
  "type": "task.completed",
  "created": 1794906241,
  "apiVersion": "2026-11-15",
  "data": { "task": { "task_id": "task_…", "status": "completed", "assets": [ … ] } }
}