Cách sử dụng API Devstral 2

Các nhà phát triển không ngừng tìm kiếm các công cụ để đơn giản hóa các quy trình làm việc phức tạp, và Devstral 2 của Mistral AI nổi lên như một yếu tố thay đổi cuộc chơi trong lĩnh vực này. Dòng mô hình mã hóa mã nguồn mở này, bao gồm Devstral 2 và Devstral Small 2, vượt trội trong các tác vụ như khám phá codebase, sửa lỗi và chỉnh sửa nhiều tệp. Điều gì làm nó trở nên khác biệt? Việc tích hợp với Mistral API cho phép truy cập liền mạch vào khả năng tạo mã hiệu suất cao trực tiếp trong các ứng dụng của bạn. Hơn nữa, việc kết hợp nó với công cụ Vibe CLI cho phép tự động hóa dựa trên terminal một cách trực quan mà vẫn mạnh mẽ.

button

Tìm hiểu Devstral 2: Phân tích kỹ thuật về dòng mô hình

Các kỹ sư của Mistral AI đã thiết kế Devstral 2 để giải quyết trực tiếp các thách thức kỹ thuật phần mềm trong thế giới thực. Về cốt lõi, Devstral 2 – một transformer dày đặc 123B tham số – xử lý mã với độ chính xác cao, đạt 72,2% trên điểm chuẩn SWE-bench Verified. Điểm số này phản ánh khả năng tự động giải quyết các vấn đề trên GitHub, vượt trội so với các mô hình như DeepSeek V3.2 với tỷ lệ thắng 42,8% trong các đánh giá của con người. Do đó, các nhóm sử dụng nó cho các tác vụ cấp sản xuất mà không gặp phải chi phí vận hành quá lớn như các đối thủ cạnh tranh lớn hơn.

Trong khi đó, Devstral Small 2, với 24B tham số, nhắm đến các môi trường có tài nguyên hạn chế. Nó đạt 68,0% trên SWE-bench và giới thiệu khả năng hỗ trợ đa phương thức, chấp nhận đầu vào hình ảnh cho các tác vụ như tạo mã dựa trên ảnh chụp màn hình. Cả hai mô hình đều hoạt động dưới các giấy phép cho phép: Devstral 2 thông qua giấy phép MIT đã sửa đổi, và Devstral Small 2 dưới Apache 2.0. Sự cởi mở này khuyến khích đóng góp từ cộng đồng và tinh chỉnh tùy chỉnh.

Về mặt kỹ thuật, các mô hình này tận dụng cửa sổ ngữ cảnh 256K token, cho phép chúng tiếp nhận toàn bộ các kho lưu trữ để phân tích toàn diện. Ví dụ, Devstral 2 theo dõi các phụ thuộc khung giữa các tệp, phát hiện lỗi và đề xuất thử lại—các tính năng giúp giảm gỡ lỗi thủ công tới 50% trong các điểm chuẩn. Hơn nữa, kiến trúc của nó được tối ưu hóa để tiết kiệm chi phí; các nhà phát triển báo cáo tiết kiệm gấp 7 lần so với Claude Sonnet cho các đầu ra tương đương.

Hãy xem xét các tác động đối với việc sử dụng trong doanh nghiệp. Devstral 2 xử lý suy luận cấp kiến trúc, hiện đại hóa các hệ thống cũ bằng cách tái cấu trúc mã nguyên khối thành các microservice. Ngược lại, Devstral Small 2 chạy trên các thiết lập GPU đơn, làm cho nó lý tưởng cho việc triển khai ở biên. Kết quả là, các tổ chức mở rộng khả năng mã hóa được hỗ trợ bởi AI mà không cần đại tu cơ sở hạ tầng.

Để định lượng hiệu suất, hãy xem xét các chỉ số chính:

Các thông số kỹ thuật này định vị Devstral 2 như một nền tảng đa năng cho các tác nhân mã hóa. Tiếp theo, chúng ta sẽ chuyển sang Vibe CLI, công cụ mang sức mạnh này đến dòng lệnh của bạn.

Khám phá Vibe CLI: Giao diện dòng lệnh cho tự động hóa Devstral 2

Vibe CLI là công cụ mã nguồn mở đồng hành của Mistral AI với Devstral 2, biến các yêu cầu ngôn ngữ tự nhiên thành các thay đổi mã có thể thực thi. Các nhà phát triển cài đặt nó thông qua một lệnh curl đơn giản: curl -LsSf https://mistral.ai/vibe/install.sh | bash. Sau khi thiết lập, nó khởi chạy một giao diện trò chuyện tương tác trong terminal, hoàn chỉnh với tính năng tự động hoàn thành và lịch sử lưu trữ bền vững.

Điều gì làm cho Vibe CLI hiệu quả? Nó tích hợp ngữ cảnh nhận biết dự án, quét các thư mục để tham chiếu các tệp bằng ký hiệu @. Ví dụ, gõ @main.py để đưa một tập lệnh vào để phân tích. Ngoài ra, thực hiện các lệnh shell bằng cách sử dụng !, chẳng hạn như !git status, để tích hợp kiểm soát phiên bản một cách liền mạch. Các lệnh dấu gạch chéo cũng tăng cường khả năng sử dụng: /config điều chỉnh cài đặt, trong khi /theme tùy chỉnh giao diện.

Về cơ bản, Vibe CLI tuân thủ Giao thức Giao tiếp Tác nhân (Agent Communication Protocol), cho phép các tiện ích mở rộng IDE như plugin của Zed. Cấu hình nó thông qua tệp config.toml, nơi bạn chỉ định các nhà cung cấp mô hình (ví dụ: các phiên bản Devstral cục bộ hoặc khóa API của Mistral), quyền công cụ và các quy tắc tự động phê duyệt cho các lần thực thi. Sự linh hoạt này ngăn chặn sự vượt quá giới hạn; đối với các dự án nhạy cảm, hãy tắt chức năng ghi tệp theo mặc định.

Trong thực tế, Vibe CLI tỏa sáng trong các quy trình làm việc lặp đi lặp lại. Giả sử bạn duy trì một ứng dụng web Python. Hãy ra lệnh cho nó: "Tái cấu trúc mô-đun xác thực trong @auth.py để sử dụng JWT thay vì phiên." Vibe CLI khám phá các phụ thuộc, tạo diff và áp dụng các thay đổi thông qua !git apply. Nếu phát sinh xung đột, nó sẽ phát hiện và đề xuất các giải pháp thay thế—phản ánh cơ chế thử lại của Devstral 2.

Các điểm chuẩn cho thấy Vibe CLI hoàn thành các tác vụ đầu cuối nhanh hơn 3 lần so với chỉnh sửa thủ công trong các kịch bản đa tệp. Hơn nữa, chế độ script của nó hỗ trợ các script tự động hóa, như xử lý hàng loạt các PR review. Để chạy cục bộ, hãy ghép nối nó với Devstral Small 2 trên phần cứng tiêu dùng; thời gian suy luận giảm xuống còn vài giây mỗi phản hồi.

Tuy nhiên, sức mạnh thực sự của Vibe CLI nằm ở sự cộng hưởng API của nó. Nó đóng vai trò proxy cho các yêu cầu đến Mistral API, lưu trữ các phản hồi để tăng hiệu quả. Khi chúng ta tiếp tục, cầu nối này trở nên quan trọng cho các tích hợp tùy chỉnh.

Truy cập Devstral 2 API: Hướng dẫn triển khai từng bước

Để truy cập Devstral 2 API, bạn cần có tài khoản Mistral AI, có sẵn tại bảng điều khiển. Đăng ký sẽ cấp quyền truy cập miễn phí ngay lập tức trong thời gian giới thiệu, sau đó chuyển sang mô hình thanh toán theo mức sử dụng: 0,40 đô la đầu vào / 2,00 đô la đầu ra cho mỗi triệu token đối với Devstral 2, và 0,10 đô la / 0,30 đô la cho Devstral Small 2. Xác thực sử dụng khóa API, được tạo trong bảng điều khiển.

Bắt đầu bằng cách lấy khóa của bạn. Điều hướng đến phần API, tạo khóa mới và lưu trữ nó một cách an toàn.

API tuân theo các quy ước RESTful qua HTTPS, với các điểm cuối được lưu trữ tại https://api.mistral.ai/v1. Các hoạt động cốt lõi bao gồm hoàn thành trò chuyện, tinh chỉnh và nhúng, nhưng đối với mã hóa, hãy tập trung vào /v1/chat/completions.

Tạo các yêu cầu theo định dạng JSON. Một ví dụ curl cơ bản cho Devstral 2:

curl https://api.mistral.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -d '{
    "model": "devstral-2",
    "messages": [{"role": "user", "content": "Write a Python function to parse JSON configs."}],
    "max_tokens": 512,
    "temperature": 0.1
  }'

Cuộc gọi này trả về mã được tạo trong trường choices[0].message.content. Điều chỉnh temperature để tăng tính sáng tạo (0.0 cho các đầu ra xác định) và max_tokens cho độ dài phản hồi. Đối với các tác vụ codebase, hãy bao gồm ngữ cảnh trong lời nhắc: tiền tố nội dung tệp hoặc sử dụng thông báo hệ thống cho các hướng dẫn.

Sử dụng nâng cao liên quan đến việc truyền phát phản hồi với "stream": true, lý tưởng cho các plugin IDE thời gian thực. API hỗ trợ tới 256K token, vì vậy hãy xử lý các đầu vào lớn theo lô. Xử lý lỗi là quan trọng; các mã phổ biến bao gồm 401 (không được phép) và 429 (giới hạn tốc độ). Triển khai thử lại với phương pháp tăng dần theo cấp số nhân:

import requests
import time
import os

def call_devstral(prompt, model="devstral-2"):
    url = "https://api.mistral.ai/v1/chat/completions"
    headers = {
        "Authorization": f"Bearer {os.getenv('MISTRAL_API_KEY')}",
        "Content-Type": "application/json"
    }
    data = {
        "model": model,
        "messages": [{"role": "user", "content": prompt}],
        "max_tokens": 1024,
        "temperature": 0.2
    }
    while True:
        response = requests.post(url, json=data, headers=headers)
        if response.status_code == 429:
            time.sleep(2 ** attempt)  # Exponential backoff
            attempt += 1
        elif response.status_code == 200:
            return response.json()["choices"][0]["message"]["content"]
        else:
            raise Exception(f"API error: {response.status_code}")

# Example usage
code = call_devstral("Optimize this SQL query: SELECT * FROM users WHERE age > 30;")
print(code)

Đoạn mã Python này trình bày các lệnh gọi có khả năng phục hồi. Đối với đa phương thức với Devstral Small 2, hãy tải lên hình ảnh qua mã hóa base64 trong mảng nội dung.

Giới hạn tốc độ thay đổi theo cấp; theo dõi việc sử dụng thông qua bảng điều khiển. Các điểm cuối tinh chỉnh (/v1/fine_tuning/jobs) cho phép tùy chỉnh trên các tập dữ liệu độc quyền, yêu cầu các tệp JSONL với các cặp lời nhắc-hoàn thành.

Chuyển sang kiểm thử, Apidog đơn giản hóa việc xác thực. Nhập đặc tả OpenAPI của Mistral vào Apidog, giả lập môi trường và chạy các bộ sưu tập để mô phỏng quy trình làm việc. Cách tiếp cận này giúp phát hiện sớm các trường hợp biên.

Tích hợp Devstral 2 API với Apidog: Các phương pháp hay nhất để phát triển dựa trên API

Apidog nâng tầm việc sử dụng Devstral 2 API bằng cách cung cấp một nền tảng thống nhất cho thiết kế, kiểm thử và tài liệu. Bắt đầu bằng cách tải xuống Apidog—miễn phí cho cá nhân—và tạo một dự án mới. Dán schema API của Mistral (có sẵn trong bảng điều khiển) để tự động tạo các điểm cuối.

Tại sao lại là Apidog? Nó hỗ trợ OpenAPI 3.0, phù hợp với đặc tả của Mistral, và cung cấp các công cụ xây dựng yêu cầu trực quan. Kiểm thử hoàn thành trò chuyện: Đặt phương thức là POST, thêm mã thông báo Bearer của bạn và nhập các tải trọng JSON. Trình xem phản hồi của Apidog phân tích JSON, làm nổi bật các đầu ra mã để xem xét nhanh.

Để tự động hóa, hãy tận dụng tính năng script của Apidog. Các script tiền yêu cầu (pre-request scripts) tìm nạp ngữ cảnh động, như các thay đổi Git gần đây, trước khi truy cập API. Các script hậu phản hồi (post-response scripts) phân tích các thế hệ và kích hoạt các lệnh Vibe CLI. Ví dụ script bằng JavaScript:

// Pre-request: Fetch repo context
pm.sendRequest({
    url: 'https://api.github.com/repos/user/repo/contents/',
    method: 'GET',
    header: {
        'Authorization': 'token {{github_token}}'
    }
}, (err, res) => {
    if (!err) {
        pm.variables.set('context', res.json().map(f => f.name).join('\n'));
    }
});

// Main request uses {{context}} in prompt

Sự tích hợp này đảm bảo các lời nhắc luôn phù hợp. Hơn nữa, các tính năng cộng tác của Apidog cho phép các nhóm chia sẻ bộ sưu tập, chuẩn hóa việc sử dụng Devstral 2.

Các trường hợp sử dụng nâng cao: Tận dụng Devstral 2 và Vibe CLI trong sản xuất

Vượt xa những điều cơ bản, Devstral 2 API cung cấp sức mạnh cho các tác nhân tinh vi. Kết hợp nó với Vibe CLI cho các quy trình làm việc lai: Sử dụng CLI để tạo mẫu cục bộ, sau đó triển khai các điểm cuối API trong các đường ống CI/CD. Ví dụ, tích hợp với GitHub Actions:

name: Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run Devstral Review
        run: |
          curl -X POST https://api.mistral.ai/v1/chat/completions \
            -H "Authorization: Bearer ${{ secrets.MISTRAL_API_KEY }}" \
            -d '{
              "model": "devstral-2",
              "messages": [{"role": "user", "content": "Review changes in ${{ github.event.pull_request.diff_url }}"}]
            }' | jq '.choices[0].message.content' > review.md
      - name: Comment PR
        uses: actions/github-script@v6
        with:
          script: |
            github.rest.pulls.createReview({
              owner: context.repo.owner,
              repo: context.repo.repo,
              pull_number: context.payload.pull_request.number,
              body: fs.readFileSync('review.md', 'utf8')
            })

YAML này tự động hóa các đánh giá, kéo các thay đổi và tạo phản hồi. Vibe CLI bổ sung bằng cách xử lý các hợp nhất cục bộ: vibe "Áp dụng các thay đổi được đề xuất từ review.md".

Trong các kịch bản đa phương thức, Devstral Small 2 API xử lý ảnh chụp màn hình giao diện người dùng. Cung cấp hình ảnh base64: {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBOR..."}}. Các ứng dụng bao gồm kiểm toán khả năng truy cập, nơi mô hình đề xuất cải tiến văn bản thay thế (alt-text).

Đối với quy mô doanh nghiệp, tinh chỉnh trên dữ liệu chuyên biệt. Tải tập dữ liệu lên /v1/fine_tuning/jobs, chỉ định số epoch và tốc độ học. Sau khi đào tạo, API sẽ phục vụ các mô hình tùy chỉnh tại các điểm cuối chuyên dụng, giảm độ trễ 30%.

Điện toán biên hưởng lợi từ thời gian chạy trên thiết bị của Devstral Small 2. Triển khai qua ONNX, tích hợp các cơ chế dự phòng API cho lưu lượng truy cập quá tải. Các công cụ như Kilo Code hoặc Cline mở rộng điều này, nhúng logic Vibe CLI vào VS Code.

Các số liệu từ người dùng cho thấy năng suất tăng gấp 5 lần: Một công ty khởi nghiệp đã tái cấu trúc một hệ thống nguyên khối 100K dòng mã trong vài tuần, nhờ vào khả năng theo dõi phụ thuộc của Devstral 2.

Kết luận: Chuyển đổi công việc mã hóa của bạn với Devstral 2 API ngay hôm nay

Devstral 2 định nghĩa lại phát triển được hỗ trợ bởi AI thông qua dòng mô hình mạnh mẽ, Vibe CLI trực quan và API dễ tiếp cận. Các nhà phát triển tận dụng những công cụ này cho mọi việc từ sửa lỗi nhanh chóng đến tái cấu trúc toàn diện, được hỗ trợ bởi các điểm chuẩn ấn tượng và tiết kiệm chi phí.

Triển khai các chiến lược đã nêu — bắt đầu với cài đặt Vibe CLI, bảo mật khóa API và kiểm thử qua Apidog. Những tối ưu hóa nhỏ, như lời nhắc chính xác hoặc ngữ cảnh được lưu trữ, mang lại hiệu quả tăng cường đáng kể. Khi AI phát triển, Devstral 2 sẽ đưa bạn lên hàng đầu.

Sẵn sàng thử nghiệm? Hãy truy cập bảng điều khiển Mistral, khởi động Vibe CLI và tải Apidog miễn phí. Bước đột phá tiếp theo của bạn đang chờ đợi.

button