Introduzione alla configurazione dei modelli
Questo tutorial spiega come configurare vari modelli linguistici di grandi dimensioni nel SelectTranslate estensione, compreso API keys, URL degli endpoint, selezione del modello, parametri delle prestazioni e impostazioni dei prompt. Una corretta configurazione del modello può migliorare la stabilità del servizio e migliorare l'accuratezza della traduzione, la velocità di risposta e l'esperienza utente complessiva in diversi scenari di traduzione.
1. Configura API Key
An API key è la credenziale di accesso ufficiale fornita dal fornitore di servizi modello, utilizzata per chiamare in modo sicuro il suo AI modelli e servizi correlati.
Comune API Key Problemi di configurazione
- Non corretto API Key Formato: il API key potrebbe contenere caratteri mancanti, spazi aggiuntivi o essere troncato in modo errato. Assicurati di copiare la chiave completa fornita dal servizio ed evita di includere spazi, interruzioni di riga o altri caratteri non validi.
- API Key Mancata corrispondenza con il fornitore di servizi: API keys di diversi fornitori di modelli non sono intercambiabili. Ad esempio, un OpenAI API key non può essere utilizzato con DeepSeek modelli.
- API Key Scaduto o disabilitato: il tuo API key potrebbe essere stato revocato a causa di scadenza, disattivazione manuale, problemi dell'account, limiti di utilizzo o motivi di sicurezza. Visita la console del tuo provider per verificare lo stato attuale del tuo API key.
- Errore URL endpoint: anche con un file valido API Key, i test di connessione potrebbero non riuscire se l'URL dell'endpoint non è corretto, mancano i percorsi della versione o non soddisfa i requisiti specifici del provider.
- Mancata corrispondenza del nome del modello: assicurati che il nome del modello sia scritto correttamente e ufficialmente supportato dal tuo provider. Gli errori tipografici qui vengono spesso erroneamente identificati come API Key problemi.
- Problemi di rete o proxy: la stabilità della rete locale, le configurazioni proxy o le restrizioni del firewall possono bloccare le richieste, provocando errori di autenticazione o timeout delle richieste.
2. Selezione del modello di traduzione
Quando si configura l'estensione, il nome del modello deve corrispondere al fornitore di servizi associato a API key; in caso contrario, il modello non potrà essere richiamato correttamente.
Provider supportati e mappatura dei modelli
| Fornitore | Nome del modello |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Personalizzato API URL
L'estensione utilizza il file official API URL per impostazione predefinita, quindi in genere non sono necessarie modifiche. L'immissione manuale dell'URL è necessaria solo nei seguenti casi:
- Chiamando il modello tramite un proxy inverso o un servizio di inoltro,
- Utilizzando un servizio modello di grandi dimensioni distribuito privatamente,
- Connessione a terze parti API servizi che non utilizzano completamente l'URL predefinito ufficiale.
Linee guida per l'immissione:
- L'URL deve essere un endpoint HTTPS completo, ad esempio:
https://api.your-company.com/v1/chat/completions - Il percorso dell'endpoint deve corrispondere alla documentazione tecnica del fornitore di servizi e al file API deve ricevere e gestire correttamente le richieste che seguono il formato specificato.
4. Regolazione dei parametri del modello
I seguenti parametri vengono utilizzati per regolare la qualità della traduzione, la stabilità del modello e la velocità di risposta. Le impostazioni predefinite coprono la maggior parte dei casi d'uso; adattarli secondo necessità per requisiti specifici.
| Parametri | Descrizione | Impostazioni consigliate |
|---|---|---|
| Lunghezza massima del testo per richiesta | Utilizzato per limitare il numero massimo di caratteri che possono essere inviati in una singola richiesta di traduzione. L'impostazione di questo valore troppo alto potrebbe rallentare API risposte; mantenerlo entro un intervallo ragionevole aiuta a migliorare la stabilità e la velocità di risposta. | - Consigliato 1000–1500 personaggi- Evitare di eccedere 2000 caratteri per evitare ritardi nella risposta o perdita di contenuto. |
| Numero massimo di paragrafi per richiesta | Il numero di paragrafi che possono essere inviati contemporaneamente in un'unica richiesta di traduzione. L'invio di troppi paragrafi contemporaneamente può aumentare il carico di elaborazione, portando a risposte più lente o a una stabilità ridotta. L'impostazione appropriata di questo valore aiuta a migliorare l'efficienza e l'affidabilità complessive della traduzione. | - Testi tecnici o giuridici:1(elaborare paragrafo per paragrafo per garantire l'accuratezza della terminologia)- Romanzi, dialoghi o blog: 3–5(migliora la fluidità) |
| Richieste massime al secondo | Il numero di richieste di traduzione inviate al secondo. Se il tasso di richieste è troppo alto, verranno messe in coda ulteriori richieste per evitare di raggiungere API limiti di velocità e per mantenere la stabilità complessiva del sistema. | -Uso generale:25- Servizi a tariffa rigorosa (ad es. Gemini): 8–10 |
| Temperatura | Controlla la casualità e la variabilità dell'output del modello. Valori di temperatura più elevati producono risposte più diversificate e creative, mentre valori più bassi si traducono in risultati più stabili, il che è preferibile per traduzioni coerenti e accurate. | - Raccomandazione per attività di traduzione: le temperature ufficiali consigliate variano in base al modello. Si consiglia di utilizzare l'impostazione predefinita fornita e di modificarla secondo necessità. |
5. Prompt personalizzati (prompt di sistema/prompt utente)
L'estensione include suggerimenti di traduzione generali integrati e ottimizzati che coprono gli scenari di traduzione più comuni. Quando esistono requisiti specifici, come stile di traduzione, coerenza terminologica, competenza nel settore o preferenze di tono, è possibile utilizzare istruzioni personalizzate per ottimizzare l'output del modello.
Quando si creano richieste di traduzione personalizzate, si consiglia di seguire queste linee guida:
- Istruzioni chiare e specifiche: specifica chiaramente la lingua di destinazione, lo stile di traduzione, il dominio ed eventuali espressioni o scelte di parole da evitare.
- Istruzioni attuabili: utilizza descrizioni concrete e precise, evitando affermazioni vaghe o astratte, per garantire che il modello possa comprendere e seguire accuratamente le istruzioni.
- Mantieni i prompt concisi: assicurati che il prompt fornisca informazioni sufficienti pur rimanendo breve, evitando dettagli ridondanti che potrebbero interferire con la comprensione del modello.
6. Dichiarazione di non responsabilità
🔔 Tieni presente il livello gratuito e le eventuali commissioni addebitate dal fornitore del servizio per evitare costi imprevisti.