DeepResearch Quickstart

from valyu import Valyu

valyu = Valyu()

# Create a task
task = valyu.deepresearch.create(
    query="What are the key differences between RAG and fine-tuning for LLMs?",
    mode="standard"
)

# Wait for it to finish (polls automatically)
result = valyu.deepresearch.wait(task.deepresearch_id)

print(result.output)
for source in result.sources:
    print(f"- {source.title}: {source.url}")
print(f"Cost: ${result.cost}")

import { Valyu } from "valyu-js";

const valyu = new Valyu();

// Create a task
const task = await valyu.deepresearch.create({
  query: "What are the key differences between RAG and fine-tuning for LLMs?",
  mode: "standard"
});

// Wait for it to finish (polls automatically)
const result = await valyu.deepresearch.wait(task.deepresearch_id);

console.log(result.output);
result.sources?.forEach(s => console.log(`- ${s.title}: ${s.url}`));
console.log(`Cost: $${result.cost}`);

# Create a task, then poll GET /v1/deepresearch/tasks/{id}/status until completed
curl -X POST "https://api.valyu.ai/v1/deepresearch/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "What are the key differences between RAG and fine-tuning for LLMs?",
    "mode": "standard"
  }'