Guida API DeepSeek R1

DeepSeek R1 è un termine di ricerca comune per la capacità di ragionamento di DeepSeek. Per le attuali integrazioni API, utilizza la modalità di pensiero DeepSeek V4 Pro; il punto di ingresso legacy di compatibilità deepseek-reasoner è programmato per il ritiro dopo il 24 luglio 2026.

Cosa Rende Diverso DeepSeek R1

A differenza dei modelli chat standard, R1:

1. Ragiona prima di rispondere: la modalità di pensiero restituisce il ragionamento in un campo separato reasoning_content
2. Eccelle nel ragionamento formale: dimostrazioni matematiche, verifica del codice, puzzle logici
3. Pesi aperti: il modello base è open-source (pesi disponibili su HuggingFace)
4. Prestazioni competitive: eguaglia o1 su molti benchmark a un costo molto inferiore

Avvio Rapido dell'API DeepSeek R1

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_APIMASTER_KEY",
    base_url="https://apimaster.ai/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": "Dimostra che la radice quadrata di 2 è irrazionale.",
        }
    ],
    max_tokens=2048,  # R1 necessita di più token per il ragionamento
)

message = response.choices[0].message
print(getattr(message, "reasoning_content", ""))
print(message.content)

Comprendere l'Output del Ragionamento

La modalità di pensiero DeepSeek V4 solitamente restituisce il ragionamento separatamente dalla risposta finale:

message = response.choices[0].message
reasoning = getattr(message, "reasoning_content", "")
answer = message.content
print(answer)

Strategie di Prompt per DeepSeek R1

Matematica e Dimostrazioni

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": """Risolvi passo dopo passo:
Trova tutte le soluzioni intere per: x² - 5y² = 1

Mostra il tuo ragionamento."""
        }
    ],
    max_tokens=3000,
)

Verifica del Codice

code = """
def merge_sort(arr):
    if len(arr) <= 1:
        return arr
    mid = len(arr) // 2
    left = merge_sort(arr[:mid])
    right = merge_sort(arr[mid:])
    return merge(left, right)
"""

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": f"Verifica che questa implementazione di merge sort sia corretta:\n\n```python\n{code}\n```\n\nTrova eventuali bug o casi limite."
        }
    ],
)

Logica a Più Passaggi

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": """Hai 3 scatole. Una contiene solo mele, una solo arance, una entrambe. Tutte le scatole sono etichettate in modo errato. Puoi estrarre un frutto da una scatola. Quale scatola scegli e perché?"""
        }
    ],
)

DeepSeek R1 vs Altri Modelli di Ragionamento

Modello	Punti di Forza	Fascia di Prezzo	Contesto
deepseek-v4-pro	Matematica, scienza, ragionamento complesso	Prezzi in tempo reale	1M
o3 (OpenAI)	Ragionamento ampio	Alto	200K
o4-mini	Ragionamento veloce	Medio	128K
claude-opus-4-8	Analisi complessa	Alto	1M

I modelli di ragionamento DeepSeek sono spesso convenienti, ma il prezzo varia in base al livello del modello, al tasso di cache hit e alla lunghezza dell'output.

Gestione di Output di Ragionamento Lunghi

R1 può produrre output molto lunghi: imposta max_tokens alto per compiti complessi:

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Risolvi questo problema di calcolo: ..."}],
    max_tokens=4096,  # Limite alto per ragionamenti complessi
)

# Verifica se l'output è stato troncato
if response.choices[0].finish_reason == "length":
    print("Attenzione: Output troncato — aumenta max_tokens")

Streaming delle Risposte R1

Per una migliore esperienza utente su compiti di ragionamento lunghi:

with client.chat.completions.stream(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Spiega i teoremi di incompletezza di Gödel."}],
    max_tokens=3000,
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Prezzi dell'API DeepSeek R1

Modello	Input (per 1M)	Output (per 1M)
DeepSeek V4 Pro	$0.435 listino	$0.87 listino
DeepSeek V4 Flash	$0.14 listino	$0.28 listino

Consulta il marketplace APIMaster per le tariffe scontate correnti.

Ottieni l'Accesso all'API DeepSeek R1

Domande Frequenti

Cos'è DeepSeek R1? DeepSeek R1 è il nome più vecchio che gli utenti associano al ragionamento DeepSeek. Le attuali integrazioni API dovrebbero utilizzare la modalità di pensiero DeepSeek V4, che espone il ragionamento tramite reasoning_content.

Quando dovrei usare DeepSeek R1 invece di V4? Usa la modalità di pensiero V4 Pro per matematica, logica formale, problemi scientifici e compiti in cui il ragionamento migliora la precisione. Usa V4 Flash o la modalità senza pensiero per compiti sensibili alla velocità.

Come analizzo l'output di pensiero di DeepSeek R1 in Python? Leggi reasoning_content per la traccia del ragionamento e content per la risposta finale. Evita di fare affidamento sull'analisi dei tag thinking per le attuali integrazioni API.

Quanto costa DeepSeek R1? Il prezzo varia in base al livello V4 Flash/Pro, al tasso di cache hit e alla lunghezza dell'output. Consulta i prezzi live di APIMaster.

DeepSeek R1 è disponibile tramite APIMaster? Sì — usa l'ID modello deepseek-v4-pro con l'endpoint compatibile con OpenAI di APIMaster.

Inizia → · Guida API DeepSeek → · Prezzi DeepSeek →