技能 编程开发 Groq SDK升级与模型迁移指南

Groq SDK升级与模型迁移指南

v20260423
groq-upgrade-migration
本指南为开发者提供了升级 groq-sdk 包和迁移过时 Groq 模型ID的完整指引。它详细列出了模型弃用时间表、分步升级流程和最佳实践,帮助开发者确保应用程序能顺利适配最新版本的 Groq API,保证项目持续稳定运行。
获取技能
474 次下载
概览

Groq Upgrade & Migration

Current State

!npm list groq-sdk 2>/dev/null | grep groq-sdk || echo 'groq-sdk not installed'
!pip show groq 2>/dev/null | grep -E "Name|Version" || echo 'groq not installed (python)'

Overview

Guide for upgrading the groq-sdk package and migrating away from deprecated model IDs. Groq regularly deprecates older models in favor of newer, faster alternatives.

Model Deprecation Timeline

Groq announces deprecations with advance notice. These models have been deprecated:

Deprecated ModelDeprecation DateReplacement
mixtral-8x7b-327682025-03-05llama-3.3-70b-versatile or llama-3.1-8b-instant
gemma2-9b-it2025-08-08llama-3.1-8b-instant
llama-3.1-70b-versatile2024-12-06llama-3.3-70b-versatile
llama-3.1-70b-specdec2024-12-06llama-3.3-70b-specdec
playai-tts2025-12-23Orpheus TTS models
playai-tts-arabic2025-12-23Orpheus TTS models
distil-whisper-large-v3-en—whisper-large-v3-turbo

Current Model IDs (Use These)

Model IDTypeContextSpeed
llama-3.1-8b-instantText128K~560 tok/s
llama-3.3-70b-versatileText128K~280 tok/s
llama-3.3-70b-specdecText128KFaster
meta-llama/llama-4-scout-17b-16e-instructVision+Text128K~460 tok/s
meta-llama/llama-4-maverick-17b-128e-instructVision+Text128K—
whisper-large-v3Audio STT—164x RT
whisper-large-v3-turboAudio STT—216x RT

Always verify at: GET https://api.groq.com/openai/v1/models

Instructions

Step 1: Check Current Version and Models

set -euo pipefail
# SDK version
npm list groq-sdk 2>/dev/null
npm view groq-sdk version  # latest on npm

# Find all model references in your code
grep -rn "model.*['\"]" src/ --include="*.ts" --include="*.js" | grep -i "groq\|llama\|mixtral\|gemma\|whisper"

Step 2: Upgrade SDK

set -euo pipefail
# Create upgrade branch
git checkout -b chore/upgrade-groq-sdk

# Update to latest
npm install groq-sdk@latest

# Check for breaking changes
npm ls groq-sdk

Step 3: Find and Replace Deprecated Models

// Find-and-replace map for deprecated model IDs
const MODEL_MIGRATIONS: Record<string, string> = {
  "mixtral-8x7b-32768": "llama-3.3-70b-versatile",
  "gemma2-9b-it": "llama-3.1-8b-instant",
  "llama-3.1-70b-versatile": "llama-3.3-70b-versatile",
  "llama-3.1-70b-specdec": "llama-3.3-70b-specdec",
  "llama3-70b-8192": "llama-3.3-70b-versatile",
  "llama3-8b-8192": "llama-3.1-8b-instant",
  "distil-whisper-large-v3-en": "whisper-large-v3-turbo",
};

function resolveModel(model: string): string {
  if (model in MODEL_MIGRATIONS) {
    console.warn(`Model ${model} is deprecated. Using ${MODEL_MIGRATIONS[model]} instead.`);
    return MODEL_MIGRATIONS[model];
  }
  return model;
}

Step 4: Run Migration Scanner

set -euo pipefail
# Automated scan for deprecated patterns
echo "=== Deprecated Model IDs ==="
grep -rn "mixtral-8x7b\|gemma2-9b\|llama-3.1-70b-versatile\|llama3-70b\|llama3-8b\|distil-whisper" \
  src/ --include="*.ts" --include="*.js" --include="*.py" || echo "None found"

echo ""
echo "=== Old Import Patterns ==="
grep -rn "from '@groq/sdk'\|from \"@groq/sdk\"\|require('@groq/sdk')" \
  src/ --include="*.ts" --include="*.js" || echo "None found (correct import is 'groq-sdk')"

echo ""
echo "=== Deprecated Method Calls ==="
grep -rn "\.ping()\|\.healthCheck()\|GroqClient\|GroqError" \
  src/ --include="*.ts" --include="*.js" || echo "None found"

Step 5: Validate and Test

set -euo pipefail
# Run tests
npm test

# Verify models are current
curl -s https://api.groq.com/openai/v1/models \
  -H "Authorization: Bearer $GROQ_API_KEY" | \
  jq -r '.data[].id' | sort

# Integration test
node -e "
const Groq = require('groq-sdk').default;
const g = new Groq();
g.chat.completions.create({
  model: 'llama-3.1-8b-instant',
  messages: [{role: 'user', content: 'ping'}],
  max_tokens: 5
}).then(r => console.log('OK:', r.choices[0].message.content));
"

Step 6: Rollback If Needed

set -euo pipefail
# Pin to previous version
npm install groq-sdk@0.11.0 --save-exact
npm test

SDK Changelog Highlights

The groq-sdk package mirrors the OpenAI SDK structure. Key changes to watch:

  • New model IDs added to type definitions
  • Response type changes (e.g., new usage fields)
  • Constructor options changes
  • New endpoint support (vision, audio, TTS)

Always check the GitHub releases.

Error Handling

IssueSymptomSolution
Deprecated model400 model_not_found or 400 model_decommissionedReplace with current model ID
Type errors after upgradeTypeScript compilation failsCheck SDK changelog for type changes
Auth format change401 after upgradeVerify constructor uses apiKey, not key
New required fields400 on previously working requestsCheck API docs for parameter changes

Resources

Next Steps

For CI integration during upgrades, see groq-ci-integration.

信息
分类 编程开发
名称 groq-upgrade-migration
版本 v20260423
大小 5.98KB
更新时间 2026-04-26
语言