Tài liệu API

Bắt đầu nhanh

Đăng nhập, tạo API key trong hồ sơ và nạp số dư. Gửi Authorization: Bearer QWQ_API_KEY. Lưu key trong biến môi trường máy chủ.

export QWQ_API_KEY='qwq_your_key_here'

curl https://qwq32.com/api/v1/answer \
  -H "Authorization: Bearer $QWQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "What causes the aurora borealis?"
}'

URL cơ sở: https://qwq32.com/api/v1

API khả dụng

Tham số và ví dụ

Answer

query bắt buộc, không trống, tối đa 400 ký tự. Tùy chọn: freshness (day/week/month/year hoặc YYYY-MM-DDtoYYYY-MM-DD), country, language, safesearch và include_domains / exclude_domains / boost_domains. Mỗi danh sách tối đa 500 miền. include_domains không kết hợp với hai danh sách khác. country và language dùng mã được You.com hỗ trợ.

curl https://qwq32.com/api/v1/answer \
  -H "Authorization: Bearer $QWQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "Recent advances in renewable energy",
  "freshness": "month",
  "language": "EN",
  "safesearch": "moderate",
  "include_domains": [
    "energy.gov"
  ]
}'

Research

input bắt buộc, không trống, tối đa 40.000 ký tự. research_effort: lite, standard (mặc định), deep, exhaustive, frontier. source_control hỗ trợ danh sách miền, freshness, country, với quy tắc kết hợp như Answer. background tùy chọn. Chỉ định ngôn ngữ trả lời trong input.

curl https://qwq32.com/api/v1/research \
  -H "Authorization: Bearer $QWQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "Compare three battery technologies. Respond in Chinese.",
  "research_effort": "deep",
  "background": true,
  "source_control": {
    "freshness": "year",
    "exclude_domains": [
      "example.com"
    ]
  }
}'

output_schema tùy chọn dùng tập con JSON Schema của You.com, trả về đối tượng trong output.content; lite không hỗ trợ. Gốc phải là object; mọi đối tượng đặt additionalProperties:false và mọi thuộc tính nằm trong required. Dịch vụ nguồn kiểm tra cấu trúc, độ sâu, số thuộc tính; yêu cầu thất bại được hoàn tiền.

Finance Research

input bắt buộc, không trống, tối đa 40.000 ký tự. research_effort chỉ hỗ trợ deep (mặc định) và exhaustive. Finance chạy đồng bộ và có thể mất khoảng sáu phút.

curl https://qwq32.com/api/v1/finance_research \
  -H "Authorization: Bearer $QWQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "Analyze the latest NVIDIA earnings and cite sources.",
  "research_effort": "deep"
}'

Từ chối trường không xác định. Nội dung yêu cầu tối đa 180.000 byte. Không được chỉ định người dùng, giá hoặc API key nguồn.

Phản hồi đồng bộ

HTTP 200 giữ các trường answer, citations, results của Answer và thêm billing với phí, mã yêu cầu, số dư sau khấu trừ. Tiền tệ USD; một đơn vị số dư bằng $0.0000001.

{
  "answer": "A cited answer [[1]]",
  "citations": [
    {
      "source": "https://example.com",
      "excerpts": [
        "Supporting evidence"
      ]
    }
  ],
  "results": {
    "web": []
  },
  "billing": {
    "request_id": "uuid",
    "cost_usd": 0.02,
    "cost_units": 200000,
    "balance_usd": 9.98
  }
}

Research và Finance trả output.content, output.content_type, output.sources và billing. Trích dẫn [[1]] ứng với nguồn đầu tiên. Research có cấu trúc trả đối tượng JSON trong output.content.

Nghiên cứu nền

Research deep, exhaustive, frontier tự chạy nền và trả HTTP 202. lite / standard bật bằng background:true. Lưu task_id của QwQ và lấy kết quả trong 24 giờ. Chỉ tính phí một lần khi gửi, kiểm tra trạng thái miễn phí.

{
  "task_id": "qwq-task-uuid",
  "status": "queued",
  "expires_at": "2026-10-04T00:00:00.000Z",
  "billing": {
    "request_id": "qwq-task-uuid",
    "cost_usd": 0.3,
    "cost_units": 3000000,
    "balance_usd": 9.7
  }
}

curl https://qwq32.com/api/v1/research/QWQ_TASK_ID \
  -H "Authorization: Bearer $QWQ_API_KEY"

Kiểm tra mỗi 5–15 giây. Trạng thái: submitting, queued, running, completed, failed. Đọc result.output khi completed; failed kèm QUERY_FAILED_REFUNDED. Mọi key hoạt động của tài khoản sở hữu có thể lấy tác vụ. Lỗi kiểm tra tạm thời có thể thử lại, không hoàn tiền tác vụ đang chạy.

{
  "task_id": "qwq-task-uuid",
  "status": "completed",
  "expires_at": "2026-10-04T00:00:00.000Z",
  "result": {
    "output": {
      "content": "A researched report [[1]]",
      "content_type": "text",
      "sources": [
        {
          "url": "https://example.com",
          "title": "Source"
        }
      ]
    }
  }
}

Ví dụ tích hợp máy chủ

JavaScript / Node.js

const response = await fetch("https://qwq32.com/api/v1/answer", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QWQ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "What causes the aurora borealis?" }),
});
const data = await response.json();
if (!response.ok) throw new Error(data.code);
console.log(data.answer, data.billing.cost_usd);

Python / requests

import os
import requests

response = requests.post(
    "https://qwq32.com/api/v1/finance_research",
    headers={"Authorization": f"Bearer {os.environ['QWQ_API_KEY']}"},
    json={"input": "Analyze NVIDIA earnings", "research_effort": "deep"},
    timeout=370,
)
response.raise_for_status()
print(response.json()["output"]["content"])

Giá mỗi lần gọi

Giá lấy cùng cấu hình với trang web và dùng chung số dư. Khấu trừ trước khi chạy, hoàn tiền thất bại đúng một lần. Tác vụ chưa hoàn tất hết hạn cũng tự hoàn tiền. Nạp tối thiểu $10, không thuê bao.

Xử lý lỗi

Lỗi trả JSON với trường code mô tả nguyên nhân.

400 / 413

INVALID_REQUEST / QUERY_TOO_LONG: Tham số sai hoặc nội dung quá lớn, không tính phí.

401

INVALID_API_KEY: Thiếu key, key sai hoặc đã thu hồi.

402

INSUFFICIENT_BALANCE: Không đủ số dư, không gọi dịch vụ nguồn.

404 / 410

JOB_NOT_FOUND / JOB_EXPIRED: Tác vụ không tồn tại, thuộc tài khoản khác hoặc đã hết hạn.

502 / 503

QUERY_FAILED_REFUNDED: Yêu cầu thất bại và đã hoàn tiền. JOB_POLL_FAILED: Lỗi kiểm tra tạm thời, có thể thử lại. SERVICE_UNAVAILABLE / BILLING_UNAVAILABLE: Dịch vụ tạm không khả dụng; tính phí có thể chưa được đối soát, hãy kiểm tra lịch sử trước.

Mỗi POST mới là truy vấn tính phí mới, không hỗ trợ gửi lại truy vấn theo cơ chế idempotency. Kiểm tra lịch sử sau lỗi mạng hoặc tính phí. Nếu biết mã tác vụ, chỉ thử lại GET.

Quyền riêng tư và lịch sử

Chỉ lưu mã băm SHA-256 của key; hiển thị một lần và có thể thu hồi. Lịch sử hiển thị 100 lần gọi tính phí gần nhất với công cụ, mức độ, phí, trạng thái, tên key. Trang không lưu câu hỏi, câu trả lời hay báo cáo. Nguồn giữ kết quả nền tạm thời; hãy lấy sớm và lưu trong hệ thống của bạn.