Cost Optimization

// Single task - auto-terminates
const result = await fetch("https://api.webrun.ai/start/run-task", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    task: {
      prompt: "Extract data from this page"
    }
  })
});

// Multi-task - terminate on last task
const finalTask = await fetch("https://api.webrun.ai/start/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    sessionId,
    message: {
      actionType: "newTask",
      prompt: "Final task here",
      terminateOnCompletion: true
    }
  }
});

"Please navigate to the Amazon website and then perform a search for wireless keyboards. After you get the results, I need you to look through them carefully and find the ones that have good ratings, preferably above 4 stars, and then return me a list of the top 5 products with their titles, prices, and rating information."

"Go to Amazon, search 'wireless keyboard'. Return top 5 with rating ≥ 4.0 as JSON: title, price, rating."

{
  "mode": "default",
  "task": {
    "prompt": "Search for products",
    "startingUrl": "https://amazon.com"  // Skips "go to amazon.com" step
  }
}

{
  "task": {
    "prompt": "Quick search task",
    "maxDuration": 30000  // 30 seconds max task duration
  }
}

await runTask("Go to amazon.com");      // New session
await runTask("Search for keyboards");  // Another new session
await runTask("Get first result");      // Yet another session

const session = await startSession("Go to amazon.com");
await sendTask(session, "Search for keyboards");
await sendTask(session, "Get first result", { terminateOnCompletion: true });

{
  "task": {
    "prompt": "Get product price",
    "maxInputTokens": 10000,   // Lower for simple tasks (default: 100000)
    "maxOutputTokens": 1000    // Lower for short responses (default: 100000)
  }
}

{
  "proxy": {
    "source": "custom",
    "type": "http",
    "host": "your-proxy.com",
    "port": "8080"
  },
  "task": {
    "prompt": "Download all product images from the catalog"
  }
}

{
  "success": true,
  "sessionId": "abc123",
  "taskId": "xyz789",
  "type": "task_completed",
  "data": {
    "message": "Task completed successfully"
  },
  "usage": {
    "prompt_tokens": 12450,
    "completion_tokens": 3200,
    "total_tokens": 15650,
    "completion_time": 23.5,
    "cost": 0.0124
  }
}

// Creates 3 separate sessions
const result1 = await runTask("Go to amazon.com");
await sleep(5000); // Forgot to terminate, paying for idle time
const result2 = await runTask("Please navigate to the search box and then type in 'wireless keyboard' and press enter");
await sleep(5000);
const result3 = await runTask("Get me information about the first result");

// Single session, concise tasks, explicit termination
const session = await startSession({
  mode: "default",
  task: {
    prompt: "Go to amazon.com",
    startingUrl: "https://amazon.com",
    maxDuration: 60000  // 1 minute max
  }
});

await sendTask(session, "Search 'wireless keyboard'");

await sendTask(session, "Return first result as JSON: title, price, rating", {
  terminateOnCompletion: true
});