Cara Menggunakan API Devstral 2

Para pengembang terus mencari alat yang menyederhanakan alur kerja yang kompleks, dan Devstral 2 dari Mistral AI muncul sebagai pengubah permainan di bidang ini. Keluarga model pengkodean sumber terbuka ini, yang terdiri dari Devstral 2 dan Devstral Small 2, unggul dalam tugas-tugas seperti eksplorasi basis kode, perbaikan bug, dan pengeditan multi-file. Apa yang membedakannya? Integrasinya dengan Mistral API memungkinkan akses tanpa batas ke generasi kode berperforma tinggi langsung di aplikasi Anda. Terlebih lagi, memasangkannya dengan alat Vibe CLI memungkinkan otomatisasi berbasis terminal yang terasa intuitif namun kuat.

Memahami Devstral 2: Penjelasan Teknis Keluarga Model

Insinyur Mistral AI merancang Devstral 2 untuk mengatasi tantangan rekayasa perangkat lunak dunia nyata secara langsung. Pada intinya, Devstral 2—transformer padat 123B parameter—memproses kode dengan presisi, mencapai 72,2% pada benchmark Terverifikasi SWE-bench. Skor ini mencerminkan kemampuannya untuk menyelesaikan masalah GitHub secara mandiri, mengungguli model seperti DeepSeek V3.2 dengan tingkat kemenangan 42,8% dalam evaluasi manusia. Akibatnya, tim mengadopsinya untuk tugas-tugas tingkat produksi tanpa biaya tambahan dari pesaing yang lebih besar.

Sementara itu, Devstral Small 2, dengan 24B parameter, menargetkan lingkungan yang terbatas sumber daya. Model ini mencetak 68,0% pada SWE-bench dan memperkenalkan dukungan multimodal, menerima masukan gambar untuk tugas-tugas seperti generasi kode berbasis tangkapan layar. Kedua model beroperasi di bawah lisensi permisif: Devstral 2 melalui MIT yang dimodifikasi, dan Devstral Small 2 di bawah Apache 2.0. Keterbukaan ini mendorong kontribusi komunitas dan fine-tuning khusus.

Secara teknis, model-model ini memanfaatkan jendela konteks 256K token, memungkinkan mereka untuk menyerap seluruh repositori untuk analisis holistik. Misalnya, Devstral 2 melacak dependensi kerangka kerja di seluruh file, mendeteksi kegagalan, dan menyarankan upaya ulang—fitur yang mengurangi debugging manual hingga 50% dalam benchmark. Selain itu, arsitekturnya dioptimalkan untuk efisiensi biaya; pengembang melaporkan penghematan 7x dibandingkan Claude Sonnet untuk output yang setara.

Pertimbangkan implikasinya untuk penggunaan perusahaan. Devstral 2 menangani penalaran tingkat arsitektur, memodernisasi sistem lama dengan merefaktor kode monolitik menjadi microservices. Sebaliknya, Devstral Small 2 berjalan pada pengaturan GPU tunggal, membuatnya ideal untuk penerapan di tepi (edge deployments). Akibatnya, organisasi dapat menskalakan pengkodean yang dibantu AI tanpa perombakan infrastruktur.

Untuk mengukur kinerja, periksa metrik utama:

Spesifikasi ini menempatkan Devstral 2 sebagai tulang punggung serbaguna untuk agen kode. Selanjutnya, kita beralih ke Vibe CLI, yang membawa kekuatan ini ke baris perintah Anda.

Menjelajahi Vibe CLI: Antarmuka Baris Perintah untuk Otomatisasi Devstral 2

Vibe CLI berdiri sebagai pendamping sumber terbuka Mistral AI untuk Devstral 2, mengubah perintah bahasa alami menjadi perubahan kode yang dapat dieksekusi. Para pengembang menginstalnya melalui perintah curl sederhana: curl -LsSf https://mistral.ai/vibe/install.sh | bash. Setelah diatur, ia meluncurkan antarmuka obrolan interaktif di terminal, lengkap dengan pelengkapan otomatis dan riwayat yang persisten.

Apa yang membuat Vibe CLI efektif? Ini menggabungkan konteks yang sadar proyek, memindai direktori untuk mereferensikan file dengan notasi `@`. Misalnya, ketik `@main.py` untuk menarik skrip untuk analisis. Selain itu, jalankan perintah shell menggunakan `!`, seperti `!git status`, untuk mengintegrasikan kontrol versi dengan lancar. Perintah garis miring semakin meningkatkan kegunaan: `/config` menyesuaikan pengaturan, sementara `/theme` menyesuaikan antarmuka.

Secara internal, Vibe CLI mematuhi Agent Communication Protocol, memungkinkan ekstensi IDE seperti plugin Zed. Konfigurasikan melalui file `config.toml`, tempat Anda menentukan penyedia model (misalnya, instans Devstral lokal atau kunci API Mistral), izin alat, dan aturan persetujuan otomatis untuk eksekusi. Fleksibilitas ini mencegah jangkauan berlebihan; untuk proyek sensitif, nonaktifkan penulisan file secara default.

Dalam praktiknya, Vibe CLI unggul dalam alur kerja iteratif. Misalkan Anda memelihara aplikasi web Python. Perintahnya: "Refaktor modul autentikasi di @auth.py untuk menggunakan JWT alih-alih sesi." Vibe CLI menjelajahi dependensi, menghasilkan perbedaan (diffs), dan menerapkan perubahan melalui `!git apply`. Jika timbul konflik, ia mendeteksinya dan mengusulkan alternatif—mencerminkan mekanisme percobaan ulang Devstral 2.

Benchmark menunjukkan Vibe CLI menyelesaikan tugas end-to-end 3x lebih cepat daripada pengeditan manual dalam skenario multi-file. Terlebih lagi, mode scripting-nya mendukung skrip otomatisasi, seperti pemrosesan massal ulasan PR. Untuk eksekusi lokal, pasangkan dengan Devstral Small 2 pada perangkat keras konsumen; waktu inferensi turun menjadi hitungan detik per respons.

Namun, kekuatan sejati Vibe CLI terletak pada sinergi API-nya. Ini mem-proxy permintaan ke Mistral API, menyimpan respons untuk efisiensi. Seiring berjalannya waktu, jembatan ini menjadi krusial untuk integrasi khusus.

Mengakses Devstral 2 API: Panduan Implementasi Langkah demi Langkah

Mengakses Devstral 2 API memerlukan akun Mistral AI, tersedia di konsol. Pendaftaran memberikan akses gratis segera selama periode pengantar, beralih ke harga bayar-sesuai-pakai: $0,40 input / $2,00 output per juta token untuk Devstral 2, dan $0,10 / $0,30 untuk Devstral Small 2. Autentikasi menggunakan kunci API, yang dibuat di dasbor konsol.

Mulailah dengan mendapatkan kunci Anda. Navigasikan ke bagian API, buat kunci baru, dan simpan dengan aman.

API ini mengikuti konvensi RESTful melalui HTTPS, dengan endpoint yang di-host di https://api.mistral.ai/v1. Operasi inti meliputi penyelesaian obrolan, fine-tuning, dan embedding, tetapi untuk pengkodean, fokus pada /v1/chat/completions.

Buat permintaan dalam format JSON. Contoh curl dasar untuk 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
  }'

Panggilan ini mengembalikan kode yang dihasilkan di bidang choices[0].message.content. Sesuaikan temperature untuk kreativitas (0.0 untuk output deterministik) dan max_tokens untuk panjang respons. Untuk tugas basis kode, sertakan konteks dalam prompt: tambahkan konten file di awal atau gunakan pesan sistem untuk instruksi.

Penggunaan lanjutan melibatkan respons streaming dengan "stream": true, ideal untuk plugin IDE real-time. API mendukung hingga 256K token, jadi kirim input besar secara batch. Penanganan kesalahan itu penting; kode umum meliputi 401 (tidak sah) dan 429 (batas laju). Terapkan percobaan ulang dengan backoff eksponensial:

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)

Potongan kode Python ini menunjukkan panggilan yang tangguh. Untuk multimodal dengan Devstral Small 2, unggah gambar melalui pengodean base64 dalam array konten.

Batas laju bervariasi berdasarkan tingkat; pantau penggunaan melalui konsol. Endpoint fine-tuning (/v1/fine_tuning/jobs) memungkinkan penyesuaian pada dataset proprietary, membutuhkan file JSONL dengan pasangan prompt-completion.

Beralih ke pengujian, Apidog menyederhanakan validasi. Impor spesifikasi OpenAPI Mistral ke Apidog, lingkungan tiruan, dan jalankan koleksi untuk mensimulasikan alur kerja. Pendekatan ini mendeteksi kasus-kasus ekstrem lebih awal.

Mengintegrasikan Devstral 2 API dengan Apidog: Praktik Terbaik untuk Pengembangan Berbasis API

Apidog meningkatkan penggunaan Devstral 2 API dengan menyediakan platform terpadu untuk desain, pengujian, dan dokumentasi. Mulailah dengan mengunduh Apidog—gratis untuk individu—dan membuat proyek baru. Tempel skema API Mistral (tersedia di konsol) untuk membuat endpoint secara otomatis.

Mengapa Apidog? Ini mendukung OpenAPI 3.0, selaras dengan spesifikasi Mistral, dan menawarkan pembangun permintaan visual. Uji penyelesaian obrolan: Atur metode ke POST, tambahkan token Bearer Anda, dan masukkan payload JSON. Penampil respons Apidog menguraikan JSON, menyoroti output kode untuk peninjauan cepat.

Untuk otomatisasi, manfaatkan scripting Apidog. Skrip pra-permintaan mengambil konteks dinamis, seperti perbedaan Git terbaru, sebelum memanggil API. Skrip pasca-respons menguraikan generasi dan memicu perintah Vibe CLI. Contoh skrip dalam 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

Integrasi ini memastikan prompt tetap relevan. Terlebih lagi, fitur kolaborasi Apidog memungkinkan tim berbagi koleksi, menstandardisasi penggunaan Devstral 2.

Kasus Penggunaan Lanjutan: Memanfaatkan Devstral 2 dan Vibe CLI dalam Produksi

Di luar dasar-dasar, Devstral 2 API menggerakkan agen-agen canggih. Gabungkan dengan Vibe CLI untuk alur kerja hibrida: Gunakan CLI untuk pembuatan prototipe lokal, lalu terapkan endpoint API dalam pipeline CI/CD. Misalnya, integrasikan dengan 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 ini mengotomatiskan ulasan, menarik perbedaan (diffs) dan menghasilkan umpan balik. Vibe CLI melengkapi dengan menangani penggabungan lokal: vibe "Terapkan perubahan yang disarankan dari review.md".

Dalam skenario multimodal, Devstral Small 2 API memproses tangkapan layar UI. Input gambar base64: {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBOR..."}}. Aplikasi termasuk audit aksesibilitas, di mana model menyarankan peningkatan teks alternatif.

Untuk skala perusahaan, lakukan fine-tuning pada data khusus domain. Unggah dataset ke /v1/fine_tuning/jobs, tentukan epoch dan learning rate. Pasca-pelatihan, API menyajikan model khusus di endpoint khusus, mengurangi latensi sebesar 30%.

Komputasi tepi (edge computing) mendapatkan manfaat dari runtime on-device Devstral Small 2. Terapkan melalui ONNX, mengintegrasikan fallback API untuk lalu lintas berlebihan. Alat seperti Kilo Code atau Cline memperluas ini, menyematkan logika Vibe CLI ke dalam VS Code.

Metrik dari pengadopsi menunjukkan peningkatan produktivitas 5x lipat: Satu startup merefaktor monolit 100 ribu baris dalam beberapa minggu, berkat pelacakan dependensi Devstral 2.

Kesimpulan: Ubah Pengkodean Anda dengan Devstral 2 API Hari Ini

Devstral 2 mendefinisikan ulang pengembangan yang dibantu AI melalui keluarga modelnya yang tangguh, Vibe CLI yang intuitif, dan API yang mudah diakses. Para pengembang memanfaatkan ini untuk segala hal mulai dari perbaikan cepat hingga refactoring penuh, didukung oleh benchmark yang mengesankan dan penghematan biaya.

Terapkan strategi yang diuraikan—mulai dengan instalasi Vibe CLI, kunci API yang aman, dan uji melalui Apidog. Optimasi kecil, seperti prompt yang tepat atau konteks yang di-cache, menghasilkan peningkatan efisiensi yang substansial. Seiring berkembangnya AI, Devstral 2 menempatkan Anda di garis depan.

Siap untuk bereksperimen? Kunjungi konsol Mistral, jalankan Vibe CLI, dan unduh Apidog secara gratis. Terobosan Anda berikutnya menanti.