Cara Menggunakan Devstral 2 API

Pengembang terus mencari alat yang menyederhanakan alur kerja yang kompleks, dan Devstral 2 dari Mistral AI muncul sebagai pengubah permainan dalam 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 berkinerja tinggi langsung di aplikasi Anda. Terlebih lagi, memadukannya dengan alat Vibe CLI memungkinkan otomatisasi berbasis terminal yang terasa intuitif namun kuat.

Memahami Devstral 2: Analisis Teknis Keluarga Model

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

Sementara itu, Devstral Small 2, dengan 24B parameter, menargetkan lingkungan dengan sumber daya terbatas. Ia 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 kustom.

Secara teknis, model-model ini memanfaatkan jendela konteks 256K token, memungkinkan mereka untuk memasukkan seluruh repositori untuk analisis holistik. Misalnya, Devstral 2 melacak dependensi kerangka kerja di seluruh file, mendeteksi kegagalan, dan menyarankan upaya ulang—fitur-fitur yang mengurangi debugging manual hingga 50% dalam benchmark. Lebih jauh, 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 merefaktorisasi kode monolitik menjadi layanan mikro. Sebaliknya, Devstral Small 2 berjalan pada pengaturan GPU tunggal, membuatnya ideal untuk penerapan di perangkat tepi. Akibatnya, organisasi meningkatkan pengkodean berbantuan 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.

Mengeksplorasi 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. 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 secara mulus. Perintah slash lebih meningkatkan kegunaan: /config menyesuaikan pengaturan, sementara /theme menyesuaikan antarmuka.

Di balik layar, Vibe CLI mematuhi Protokol Komunikasi Agen, memungkinkan ekstensi IDE seperti plugin Zed. Konfigurasikan melalui file config.toml, di mana Anda menentukan penyedia model (misalnya, instance 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. Perintahkan: "Refaktorisasi modul otentikasi di @auth.py untuk menggunakan JWT daripada sesi." Vibe CLI menjelajahi dependensi, menghasilkan diff, dan menerapkan perubahan melalui !git apply. Jika terjadi 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. Selain itu, mode skripnya mendukung skrip otomatisasi, seperti tinjauan PR pemrosesan batch. Untuk jalankan lokal, pasangkan dengan Devstral Small 2 pada perangkat keras konsumen; waktu inferensi turun menjadi beberapa detik per respons.

Namun, kekuatan sejati Vibe CLI terletak pada sinergi API-nya. Ini memproksi permintaan ke Mistral API, menyimpan respons untuk efisiensi. Saat kita melanjutkan, jembatan ini menjadi krusial untuk integrasi kustom.

Mengakses API Devstral 2: Panduan Implementasi Langkah demi Langkah

Mengakses API Devstral 2 memerlukan akun Mistral AI, tersedia di konsol. Pendaftaran memberikan akses gratis langsung selama periode perkenalan, 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. Otentikasi menggunakan kunci API, yang dihasilkan di dasbor konsol.

Mulai dengan mendapatkan kunci Anda. Navigasi ke bagian API, buat kunci baru, dan simpan dengan aman.

API mengikuti konvensi RESTful melalui HTTPS, dengan endpoint yang di-hosting di https://api.mistral.ai/v1. Operasi inti meliputi penyelesaian obrolan, fine-tuning, dan embeddings, tetapi untuk pengkodean, fokuslah 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": "Tulis fungsi Python untuk mengurai konfigurasi JSON."}],
    "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 perintah: lampirkan konten file atau gunakan pesan sistem untuk instruksi.

Penggunaan tingkat lanjut melibatkan streaming respons dengan "stream": true, ideal untuk plugin IDE real-time. API mendukung hingga 256K token, jadi batch input besar. Penanganan kesalahan penting; kode umum meliputi 401 (tidak sah) dan 429 (batas tarif). 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)  # Backoff eksponensial
            attempt += 1
        elif response.status_code == 200:
            return response.json()["choices"][0]["message"]["content"]
        else:
            raise Exception(f"API error: {response.status_code}")

# Contoh penggunaan
code = call_devstral("Optimalkan kueri SQL ini: SELECT * FROM users WHERE age > 30;")
print(code)

Cuplikan Python ini menunjukkan panggilan yang tangguh. Untuk multimodal dengan Devstral Small 2, unggah gambar melalui pengkodean base64 di array konten.

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

Beralih ke pengujian, Apidog menyederhanakan validasi. Impor spesifikasi OpenAPI Mistral ke Apidog, lingkungan mock, dan jalankan koleksi untuk mensimulasikan alur kerja. Pendekatan ini menangkap kasus tepi sejak dini.

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

Apidog meningkatkan penggunaan API Devstral 2 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 secara otomatis menghasilkan endpoint.

Mengapa Apidog? Ia 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 tinjauan cepat.

Untuk otomatisasi, manfaatkan skrip Apidog. Skrip pra-permintaan mengambil konteks dinamis, seperti diff Git terbaru, sebelum mencapai API. Skrip pasca-respons mengurai generasi dan memicu perintah Vibe CLI. Contoh skrip dalam JavaScript:

// Pra-permintaan: Ambil konteks repo
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'));
    }
});

// Permintaan utama menggunakan {{context}} dalam prompt

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

Kasus Penggunaan Tingkat Lanjut: Memanfaatkan Devstral 2 dan Vibe CLI dalam Produksi

Di luar dasar-dasar, API Devstral 2 mendukung agen yang 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: Jalankan Tinjauan Devstral
        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": "Tinjau perubahan di ${{ github.event.pull_request.diff_url }}"}]
            }' | jq '.choices[0].message.content' > review.md
      - name: Komentar 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 tinjauan, menarik diff 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. Beri makan 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, fine-tune pada data spesifik domain. Unggah dataset ke /v1/fine_tuning/jobs, tentukan epoch dan learning rate. Setelah pelatihan, API menyajikan model kustom di endpoint khusus, mengurangi latensi sebesar 30%.

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

Metrik dari pengadopsi menunjukkan peningkatan produktivitas 5x: Sebuah startup merefaktor monolit 100K baris dalam hitungan minggu, memuji pelacakan dependensi Devstral 2.

Kesimpulan: Ubah Pengkodean Anda dengan API Devstral 2 Hari Ini

Devstral 2 mendefinisikan ulang pengembangan berbantuan AI melalui keluarga modelnya yang tangguh, Vibe CLI yang intuitif, dan API yang mudah diakses. 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—mulailah dengan instalasi Vibe CLI, amankan kunci API, dan uji melalui Apidog. Optimalisasi kecil, seperti prompt yang tepat atau konteks yang di-cache, menghasilkan peningkatan efisiensi yang substansial. Saat AI berkembang, Devstral 2 menempatkan Anda di garis depan.

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