Devstral 2 API 사용법

Ashley Innocent

Ashley Innocent

10 December 2025

Devstral 2 API 사용법

개발자들은 복잡한 워크플로우를 간소화하는 도구를 끊임없이 찾고 있으며, Mistral AI의 Devstral 2는 이 분야에서 혁신적인 변화를 가져왔습니다. Devstral 2와 Devstral Small 2로 구성된 이 오픈소스 코딩 모델 제품군은 코드베이스 탐색, 버그 수정, 다중 파일 편집과 같은 작업에서 탁월한 성능을 발휘합니다. 무엇이 특별할까요? Mistral API와의 통합을 통해 애플리케이션에서 고성능 코드 생성에 원활하게 접근할 수 있습니다. 또한, Vibe CLI 도구와 결합하면 직관적이면서도 강력한 터미널 기반 자동화가 가능해집니다.

💡
Devstral 2 API를 살펴보면서, 이 모델이 대규모 프로젝트에 대한 심층적인 추론을 위해 256K 컨텍스트 창을 어떻게 처리하는지 이해하게 될 것입니다. 하지만 API 상호작용을 관리하려면 신뢰할 수 있는 테스트가 필요합니다. 여기서 API 설계 및 문서화를 위한 강력한 플랫폼인 Apidog가 등장합니다. 직접 시작하려면 Apidog를 무료로 다운로드하고 Mistral의 OpenAPI 사양을 가져와 Devstral 2 엔드포인트를 손쉽게 테스트해보세요. 이 설정은 통합을 검증할 뿐만 아니라 프로토타이핑도 가속화합니다.
button

Devstral 2 이해하기: 모델 제품군의 기술적 분석

Mistral AI 엔지니어들은 실제 소프트웨어 엔지니어링 문제를 정면으로 해결하기 위해 Devstral 2를 설계했습니다. 핵심적으로, 1230억 개의 매개변수를 가진 밀집형 트랜스포머인 Devstral 2는 코드를 정밀하게 처리하여 SWE-bench Verified 벤치마크에서 72.2%를 달성했습니다. 이 점수는 GitHub 문제를 자율적으로 해결하는 능력을 반영하며, 인간 평가에서 DeepSeek V3.2와 같은 모델보다 42.8% 더 높은 승률을 보였습니다. 결과적으로, 팀들은 더 큰 경쟁 모델의 오버헤드 없이 제품 수준 작업에 이를 채택하고 있습니다.

한편, 240억 개의 매개변수를 가진 Devstral Small 2는 리소스 제약이 있는 환경을 목표로 합니다. 이 모델은 SWE-bench에서 68.0%를 기록하며, 스크린샷 기반 코드 생성과 같은 작업을 위해 이미지 입력을 허용하는 멀티모달 지원을 도입했습니다. 두 모델 모두 관대한 라이선스(Devstral 2는 수정된 MIT, Devstral Small 2는 Apache 2.0) 하에 작동합니다. 이러한 개방성은 커뮤니티 기여와 맞춤형 미세 조정을 장려합니다.

기술적으로 이 모델들은 256K 토큰 컨텍스트 창을 활용하여 전체 저장소를 종합적으로 분석할 수 있습니다. 예를 들어, Devstral 2는 파일 전반의 프레임워크 종속성을 추적하고, 오류를 감지하며, 재시도를 제안합니다. 이 기능들은 벤치마크에서 수동 디버깅을 최대 50%까지 줄여줍니다. 또한, 아키텍처는 비용 효율성을 위해 최적화되어 개발자들은 동일한 출력에 대해 Claude Sonnet 대비 7배의 비용 절감 효과를 보고했습니다.

엔터프라이즈 사용에 대한 함의를 고려해봅시다. Devstral 2는 아키텍처 수준의 추론을 처리하여 모놀리식 코드를 마이크로서비스로 리팩토링함으로써 레거시 시스템을 현대화합니다. 이와 대조적으로 Devstral Small 2는 단일 GPU 설정에서 실행되므로 엣지 배포에 이상적입니다. 결과적으로, 조직은 인프라 개편 없이 AI 지원 코딩을 확장할 수 있습니다.

성능을 정량화하려면 주요 측정항목을 살펴보십시오.

모델 매개변수 SWE-bench 점수 컨텍스트 창 멀티모달 지원 라이선스
Devstral 2 1230억 72.2% 256K 아니요 수정된 MIT
Devstral Small 2 240억 68.0% 256K Apache 2.0

이러한 사양은 Devstral 2를 코드 에이전트의 다재다능한 중추로 자리매김합니다. 다음으로, 이 강력한 기능을 명령줄로 가져오는 Vibe CLI에 대해 알아보겠습니다.

Vibe CLI 탐색: Devstral 2 자동화를 위한 명령줄 인터페이스

Vibe CLI는 Mistral AI의 Devstral 2의 오픈소스 동반자로서, 자연어 프롬프트를 실행 가능한 코드 변경으로 변환합니다. 개발자들은 간단한 curl 명령으로 설치할 수 있습니다: curl -LsSf https://mistral.ai/vibe/install.sh | bash. 설정이 완료되면 터미널에서 자동 완성 및 영구 기록이 포함된 대화형 채팅 인터페이스가 시작됩니다.

Vibe CLI를 효과적으로 만드는 요인은 무엇일까요? 이 도구는 프로젝트 인식 컨텍스트를 통합하여 디렉토리를 스캔하고 @ 표기법으로 파일을 참조합니다. 예를 들어, @main.py를 입력하여 분석할 스크립트를 가져올 수 있습니다. 또한, !git status와 같이 !를 사용하여 셸 명령을 실행함으로써 버전 제어를 원활하게 통합할 수 있습니다. 슬래시 명령은 사용 편의성을 더욱 향상시킵니다: /config는 설정을 조정하고, /theme는 인터페이스를 사용자 정의합니다.

내부적으로 Vibe CLI는 Agent Communication Protocol을 준수하여 Zed의 플러그인과 같은 IDE 확장을 허용합니다. config.toml 파일을 통해 모델 공급자(예: 로컬 Devstral 인스턴스 또는 Mistral API 키), 도구 권한, 실행에 대한 자동 승인 규칙을 지정하여 구성할 수 있습니다. 이러한 유연성은 과도한 접근을 방지하며, 중요한 프로젝트의 경우 기본적으로 파일 쓰기를 비활성화할 수 있습니다.

실제로 Vibe CLI는 반복적인 워크플로우에서 빛을 발합니다. Python 웹 앱을 유지 관리한다고 가정해 봅시다. 이렇게 프롬프트를 입력하세요: "@auth.py의 인증 모듈을 세션 대신 JWT를 사용하도록 리팩토링하세요." Vibe CLI는 종속성을 탐색하고, diff를 생성하며, !git apply를 통해 변경 사항을 적용합니다. 충돌이 발생하면 이를 감지하고 대안을 제시하여 Devstral 2의 재시도 메커니즘을 반영합니다.

벤치마크에 따르면 Vibe CLI는 다중 파일 시나리오에서 수동 편집보다 종단 간 작업을 3배 더 빠르게 완료합니다. 또한, 스크립팅 모드는 PR 검토 일괄 처리와 같은 자동화 스크립트를 지원합니다. 로컬 실행의 경우, 소비자 하드웨어에서 Devstral Small 2와 함께 사용하면 응답당 추론 시간이 몇 초로 단축됩니다.

그러나 Vibe CLI의 진정한 강점은 API 시너지 효과에 있습니다. Mistral API로 요청을 프록시하고 효율성을 위해 응답을 캐시합니다. 계속 진행하면서 이 연결은 사용자 정의 통합에 중요해집니다.

Devstral 2 API 접근: 단계별 구현 가이드

Devstral 2 API에 접근하려면 콘솔에서 이용 가능한 Mistral AI 계정이 필요합니다. 가입하면 초기 기간 동안 즉시 무료 액세스가 부여되며, 이후에는 종량제 요금(Devstral 2는 백만 토큰당 입력 $0.40 / 출력 $2.00, Devstral Small 2는 $0.10 / $0.30)으로 전환됩니다. 인증은 콘솔 대시보드에서 생성된 API 키를 사용합니다.

먼저 키를 얻는 것부터 시작합니다. API 섹션으로 이동하여 새 키를 생성하고 안전하게 보관하세요.

API는 HTTPS를 통해 RESTful 규칙을 따르며, 엔드포인트는 https://api.mistral.ai/v1에 호스팅됩니다. 핵심 작업에는 채팅 완료, 미세 조정 및 임베딩이 포함되지만, 코딩의 경우 /v1/chat/completions에 집중합니다.

JSON 형식으로 요청을 작성합니다. Devstral 2에 대한 기본적인 curl 예제:

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
  }'

이 호출은 choices[0].message.content 필드에 생성된 코드를 반환합니다. 창의성을 위해 temperature(결정적 출력의 경우 0.0)를 조정하고 응답 길이를 위해 max_tokens를 조정하십시오. 코드베이스 작업의 경우, 파일 내용을 앞에 추가하거나 지침을 위해 시스템 메시지를 사용하여 프롬프트에 컨텍스트를 포함하십시오.

고급 사용법에는 실시간 IDE 플러그인에 이상적인 "stream": true를 사용한 응답 스트리밍이 포함됩니다. API는 최대 256K 토큰을 지원하므로 대규모 입력을 일괄 처리합니다. 오류 처리는 중요합니다. 일반적인 코드에는 401(권한 없음) 및 429(속도 제한)가 포함됩니다. 지수 백오프를 사용하여 재시도를 구현하십시오:

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)

이 Python 스니펫은 복원력 있는 호출을 보여줍니다. Devstral Small 2로 멀티모달을 사용하려면, 콘텐츠 배열에 base64 인코딩된 이미지를 업로드하십시오.

속도 제한은 티어에 따라 다릅니다. 콘솔을 통해 사용량을 모니터링하십시오. 미세 조정 엔드포인트(/v1/fine_tuning/jobs)는 독점 데이터 세트에 대한 사용자 지정을 허용하며, 프롬프트-완료 쌍이 포함된 JSONL 파일이 필요합니다.

테스트로 넘어가면, Apidog는 검증을 간소화합니다. Mistral OpenAPI 사양을 Apidog로 가져오고, 환경을 모의하고, 컬렉션을 실행하여 워크플로우를 시뮬레이션합니다. 이 접근 방식은 초기 단계에서 엣지 케이스를 잡아냅니다.

Apidog와 Devstral 2 API 통합: API 중심 개발을 위한 모범 사례

Apidog는 설계, 테스트 및 문서화를 위한 통합 플랫폼을 제공하여 Devstral 2 API 사용을 향상시킵니다. 개인 사용자에게 무료인 Apidog를 다운로드하여 새 프로젝트를 생성하는 것부터 시작하십시오. Mistral API 스키마(콘솔에서 사용 가능)를 붙여넣어 엔드포인트를 자동으로 생성합니다.

왜 Apidog일까요? Mistral의 사양과 일치하는 OpenAPI 3.0을 지원하며, 시각적인 요청 빌더를 제공합니다. 채팅 완성을 테스트해 보세요: 메소드를 POST로 설정하고, Bearer 토큰을 추가하고, JSON 페이로드를 입력합니다. Apidog의 응답 뷰어는 JSON을 구문 분석하고, 코드 출력을 강조 표시하여 빠른 검토를 돕습니다.

자동화를 위해 Apidog의 스크립팅을 활용하십시오. 사전 요청 스크립트는 API를 호출하기 전에 최근 Git diff와 같은 동적 컨텍스트를 가져옵니다. 응답 후 스크립트는 생성을 구문 분석하고 Vibe CLI 명령을 트리거합니다. 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

이 통합은 프롬프트가 항상 관련성을 유지하도록 보장합니다. 또한, Apidog의 협업 기능은 팀이 컬렉션을 공유하여 Devstral 2 사용을 표준화할 수 있도록 합니다.

고급 사용 사례: Devstral 2 및 Vibe CLI를 프로덕션에 활용

기본을 넘어, Devstral 2 API는 정교한 에이전트를 구동합니다. 하이브리드 워크플로우를 위해 Vibe CLI와 결합하십시오: 로컬 프로토타이핑에는 CLI를 사용하고, CI/CD 파이프라인에는 API 엔드포인트를 배포하십시오. 예를 들어, 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은 diff를 가져오고 피드백을 생성하여 검토를 자동화합니다. Vibe CLI는 로컬 병합을 처리하여 이를 보완합니다: vibe "Apply suggested changes from review.md".

멀티모달 시나리오에서 Devstral Small 2 API는 UI 스크린샷을 처리합니다. base64 이미지를 입력합니다: {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBOR..."}}. 적용 분야에는 모델이 대체 텍스트 개선을 제안하는 접근성 감사가 포함됩니다.

엔터프라이즈 규모의 경우, 도메인별 데이터로 미세 조정을 수행하십시오. /v1/fine_tuning/jobs에 데이터 세트를 업로드하고, 에포크와 학습률을 지정하십시오. 훈련 후, API는 전용 엔드포인트에서 사용자 지정 모델을 제공하여 지연 시간을 30% 줄입니다.

엣지 컴퓨팅은 Devstral Small 2의 온디바이스 런타임의 이점을 얻습니다. ONNX를 통해 배포하고, 오버플로우 트래픽에 대한 API 대체 기능을 통합하십시오. Kilo Code 또는 Cline과 같은 도구는 Vibe CLI 로직을 VS Code에 임베딩하여 이를 확장합니다.

채택 기업들의 측정 지표는 생산성 5배 증가를 보여줍니다. 한 스타트업은 Devstral 2의 종속성 추적 기능 덕분에 10만 줄짜리 모놀리식을 몇 주 만에 리팩토링했습니다.

결론: Devstral 2 API로 지금 바로 코딩을 혁신하십시오

Devstral 2는 강력한 모델 제품군, 직관적인 Vibe CLI, 접근하기 쉬운 API를 통해 AI 지원 개발을 재정의합니다. 개발자들은 인상적인 벤치마크와 비용 절감에 힘입어 간단한 수정부터 전체 리팩토링에 이르기까지 이 모든 것을 활용합니다.

제시된 전략을 구현하십시오. Vibe CLI 설치, API 키 보안, Apidog를 통한 테스트부터 시작하십시오. 정밀한 프롬프트나 캐시된 컨텍스트와 같은 작은 최적화는 상당한 효율성 향상을 가져옵니다. AI가 발전함에 따라 Devstral 2는 여러분을 선두에 세울 것입니다.

실험할 준비가 되셨습니까? Mistral 콘솔로 이동하여 Vibe CLI를 실행하고 Apidog를 무료로 다운로드하십시오. 다음 돌파구가 여러분을 기다립니다.

button

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요