NEXAI Docs

Dùng với DeepSeek Harness

Chạy DeepSeek Harness (dsh) qua NEXAI bằng provider tương thích OpenAI — Web UI hoặc cordis.yml.

DeepSeek Harness (dsh) là agent lập trình mã nguồn mở của DeepSeek, kiến trúc "mọi thứ là plugin". Nó gọi model qua endpoint tương thích OpenAI, nên trỏ sang NEXAI là dùng được — kèm lợi thế nhiều nguồn + failover của NEXAI.

Base URL:

https://getnexai.net/api/v1

Chuẩn bị

  • Node.js 18+.
  • API key NEXAI (sk-...) tạo trong dashboard → API Keys.
  • Tài khoản còn số dư và có quyền dùng model mục tiêu (ví dụ deepseek-v4-pro).

Cài & chạy

Cách nhanh nhất (Web UI cục bộ):

npx @deepseek-ai/dsh web

Bản cho dev/tuỳ biến:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
npm install
npm run dev

Cấu hình

Cách 1 — Web UI (Settings → Providers)

  1. Mở dsh (npx @deepseek-ai/dsh web) → vào Settings → Providers.
  2. Thêm một custom provider kiểu OpenAI-compatible:
TrườngGiá trị
ProtocolOpenAI
Base URLhttps://getnexai.net/api/v1
API Keykey NEXAI (sk-...)
Modeldeepseek-v4-pro (hoặc model có trong /v1/models)
  1. Lưu và chọn provider vừa thêm làm mặc định.

Lưu ý: /v1 nằm trong Base URL; dsh tự nối /chat/completions. Đừng dán origin trần, đừng lặp /v1/v1, đừng dán cả /chat/completions.

Cách 2 — Khai báo trong cordis.yml

Đặt key qua biến môi trường rồi khai provider trong cordis.yml:

export NEXAI_API_KEY="sk-YOUR_API_KEY"
plugins:
  '@deepseek-ai/dsh-plugin-llm-adapter':
    provider: 'openai'
    baseUrl: 'https://getnexai.net/api/v1'
    apiKey: 'env(NEXAI_API_KEY)'
    defaultModel: 'deepseek-v4-pro'
    temperature: 0.0

Sửa defaultModel sang bất kỳ model nào đang mở (xem GET /v1/models). YAML dạng khai báo nên đổi provider/model/tham số chỉ cần sửa file.

Kiểm tra

Mở dsh và gửi một yêu cầu bất kỳ. Nếu nhận được phản hồi từ model là xong. Đối chiếu ở Lịch sử trong dashboard để xác nhận request đã qua NEXAI.

Lưu ý

  • Chi phí trừ vào ví VND theo bảng giá.
  • Ưu tiên đặt key qua biến môi trường (env(...)), đừng ghi thẳng key vào cordis.yml hay commit lên git.
  • Nghi key bị lộ: xoá key trong dashboard và tạo key mới.