Guida Completa all'API di DeepSeek V3

Introduzione

L'API di DeepSeek V3 offre un accesso programmatico completo alle capacità del modello. Questa guida ti mostrerà come integrare e utilizzare efficacemente l'API nei tuoi progetti.

Configurazione Iniziale

Ottenere l'API Key

curl -X POST https://api.deepseekv3.com/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'


curl -X POST https://api.deepseekv3.com/api-keys \
  -H "Authorization: Bearer ${TOKEN}"

Installazione SDK

pip install deepseek-v3

npm install @deepseek/v3-sdk

go get github.com/deepseek/v3-sdk

Esempi di Utilizzo

Python SDK

from deepseek import DeepSeekV3


client = DeepSeekV3(api_key="your-api-key")


response = client.generate(
    prompt="Scrivi una funzione per ordinare un array",
    max_tokens=500,
    temperature=0.7
)


analysis = client.analyze_code(
    code="def example(): pass",
    analysis_type="security"
)


chat_response = client.chat(
    messages=[
        {"role": "system", "content": "Sei un assistente di programmazione"},
        {"role": "user", "content": "Come implemento quicksort?"}
    ]
)

Node.js SDK

const { DeepSeekV3 } = require('@deepseek/v3-sdk');

// Inizializzazione
const client = new DeepSeekV3('your-api-key');

// Generazione asincrona
async function generateCode() {
    const response = await client.generate({
        prompt: 'Implementa una REST API',
        parameters: {
            maxTokens: 1000,
            temperature: 0.8
        }
    });
    return response.text;
}

// Stream di risposte
const stream = client.streamGenerate({
    prompt: 'Spiega il pattern Observer',
    onToken: (token) => console.log(token)
});

Endpoint API REST

Struttura Base

interface ApiRequest {
    model: string;
    prompt: string;
    parameters?: {
        temperature?: number;
        max_tokens?: number;
        top_p?: number;
        frequency_penalty?: number;
        presence_penalty?: number;
    };
    stream?: boolean;
}

interface ApiResponse {
    id: string;
    choices: Array<{
        text: string;
        finish_reason: string;
    }>;
    usage: {
        prompt_tokens: number;
        completion_tokens: number;
        total_tokens: number;
    };
}

Esempi di Chiamate

Generazione di Testo

curl -X POST https://api.deepseekv3.com/v1/generate \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "prompt": "Scrivi un algoritmo di ricerca binaria",
    "parameters": {
      "temperature": 0.7,
      "max_tokens": 500
    }
  }'

Analisi del Codice

curl -X POST https://api.deepseekv3.com/v1/analyze \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "function example() { var x = 1; }",
    "analysis_type": "quality",
    "detail_level": "high"
  }'

Best Practices

Gestione degli Errori

try:
    response = client.generate(prompt="test")
except DeepSeekAPIError as e:
    if e.code == 429:
        # Rate limit exceeded
        time.sleep(60)
    elif e.code == 401:
        # Invalid API key
        refresh_api_key()
    else:
        # Altri errori
        log_error(e)

Ottimizzazione delle Richieste

Usa lo streaming per risposte lunghe
Implementa caching locale
Gestisci rate limiting
Ottimizza i prompt

Sicurezza

Proteggi le API key
Valida gli input
Limita l'accesso
Monitora l'utilizzo

Limiti e Quote

Piano Gratuito

100K token/giorno
10 richieste/minuto
Modelli base

Piano Pro

1M token/giorno
60 richieste/minuto
Tutti i modelli
Supporto prioritario

Monitoraggio e Analytics

Dashboard

stats = client.get_usage_stats(
    start_date="2024-01-01",
    end_date="2024-01-31"
)


latency = client.get_latency_metrics(
    endpoint="generate",
    timeframe="1h"
)

Logging

import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger('deepseek')

def log_request(response):
    logger.info(f"Request ID: {response.id}")
    logger.info(f"Tokens used: {response.usage.total_tokens}")

Conclusione

L'API di DeepSeek V3 offre un'interfaccia potente e flessibile per integrare capacità di IA avanzate nei tuoi progetti. Seguendo questa guida e le best practices, puoi sfruttare al meglio le sue funzionalità.