Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Protezione GPT OSS 20B
##  OpenAI — GPT OSS Safeguard 20B
## Dettagli del modello
GPT OSS Safeguard 20B è il modello di sicurezza open source compatto da 20 miliardi di parametri di OpenAI per attività leggere di moderazione dei contenuti e guardrail. Per ulteriori informazioni sullo sviluppo e sulle prestazioni del modello, consulta la scheda. [ model/service ](https://cdn.openai.com/pdf/419b6906-9da6-406c-a19d-1bb078ac7637/oai_gpt-oss_model_card.pdf)
+ **Data di lancio del modello: 29 ** ottobre 2025
+ **EOL non prima del: ** 29 ottobre 2026
+ **Periodo di validità: almeno 6 ** mesi
+ **Politica sul ciclo di vita del ** [ modello: ciclo di vita del modello (per i modelli lanciati prima del 7 settembre 2026) ](model-lifecycle-legacy.md)
+ **Data EOL del modello: ** N/A
+ **Contratti di licenza con l'utente finale e condizioni d'uso: Visualizza ** [https://huggingface.co/openai/gpt-oss-safeguard-20b/blob/main/LICENSE](https://huggingface.co/openai/gpt-oss-safeguard-20b/blob/main/LICENSE)
+ **Ciclo di vita del modello: attivo **
+ **Finestra contestuale: 128K token **
+ **Token di uscita massimi: 16K **
| **Modalità di input ** | **Modalità di output ** |
| --- | --- |
| Audio | Incorporamento |
| Immagine | Immagine |
| Discorso | Discorso |
| Testo | Testo |
| Video | Video |
## Endpoint e API supportati
Le tabelle seguenti mostrano quali endpoint e API sono supportati per GPT OSS Safeguard 20B. Per ulteriori informazioni, consulta [API supportate da Amazon Bedrock](apis.md) e [Endpoint supportati da Amazon Bedrock](endpoints.md).
**Supporto per gli endpoint **
| **Endpoint** | **Supportato ** |
| --- | --- |
| bedrock-runtime |  |
| bedrock-mantle |  |
**API supportate sull'endpoint `bedrock-runtime` **
| **Messaggi** | **Risposte** | **Completamenti delle chat ** | **Converse** | **Invoke** |
| --- | --- | --- | --- | --- |
|  |  |  |  |  |
**API supportate sull'endpoint `bedrock-mantle` **
| **Messaggi** | **Risposte** | **Completamenti delle chat ** | **Converse** | **Invoke** |
| --- | --- | --- | --- | --- |
|  |  |  |  |  |
**Nota**
Sì`bedrock-mantle`, entrambe le API utilizzano il percorso di `/v1` base, no. `/openai/v1` Usa una delle due API con questo modello:
Per le risposte, usa`/v1/responses`.
Per i completamenti della chat, usa`/v1/chat/completions`.
**Suggerimento**
Quando possibile, consigliamo di utilizzare l'`bedrock-runtime`endpoint per nuove applicazioni. Per informazioni dettagliate, vedi [Endpoint supportati da Amazon Bedrock](endpoints.md).
## Funzionalità e caratteristiche
***Caratteristiche di Bedrock * **
**Funzionalità supportate tramite endpoint `bedrock-mantle` **
| **Supportato ** | **Non supportato ** |
| --- | --- |
| + [Server-side chiamata all'utensile ](tool-use.html)
+ [Progetti ](projects.html)
+ [Client-side chiamata agli strumenti ](tool-use.html) | — |
**Funzionalità supportate tramite `bedrock-runtime` endpoint **
| **Supportato ** | **Non supportato ** |
| --- | --- |
| + [Streaming di risposta ](/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)
+ [Guardrail ](guardrails.html)
+ [Valutazione del modello ](evaluation.html)
+ [Gestione tempestiva ](prompt-management.html)
+ [Flussi ](flows.html)
+ [Agenti ](agents.html)
+ [Risultati strutturati ](structured-outputs.html) | + [Routing rapido intelligente ](prompt-routing.html)
+ [rilevamento degli abusi ](abuse-detection.html)
+ [Ottimizzazione tempestiva ](prompt-management-optimize.html)
+ [Conta i token ](count-tokens.html)
+ [Base di conoscenza ](knowledge-base.html) |
## Prezzi
Per informazioni sui prezzi, consulta la [ pagina dei prezzi di ](https://aws.amazon.com/bedrock/pricing/) Amazon Bedrock.
## Accesso programmatico
Utilizzate i seguenti ID del modello e URL degli endpoint per accedere a questo modello a livello di codice. Per ulteriori informazioni sulle API e sugli endpoint disponibili, consulta [ API supportate ed Endpoint supportati. ](apis.html) [endpoints.html](endpoints.html)
| **Endpoint** | **ID del modello ** | **In-Region URL dell'endpoint ** | **ID di geo-inferenza ** | **ID di inferenza globale ** |
| --- | --- | --- | --- | --- |
| bedrock-runtime | openai.gpt-oss-safeguard-20b | https://bedrock-runtime.{region}.amazonaws.com | Non supportata | Non supportata |
| bedrock-mantle | openai.gpt-oss-safeguard-20b | https://bedrock-mantle.{region}.api.aws/v1 | Non supportata | Non supportata |
*Ad esempio, se la regione è us-east-1 (Virginia settentrionale), l'URL dell'endpoint bedrock-runtime sarà "" e per bedrock-mantle sarà "»https://bedrock-runtime.us-east-1.amazonaws.com. https://bedrock-mantle.us-east-1.api.aws/v1 *
## Livelli di servizio
Amazon Bedrock offre diversi livelli di servizio per soddisfare i requisiti del carico di lavoro. **Standard ** fornisce l'accesso pay-per-token senza impegno (imposta o ometti il campo). `"service_tier": "default"` **Priority ** offre i tempi di risposta più rapidi a un prezzo superiore (impostato). `"service_tier": "priority"` **Flex ** offre un accesso a basso costo per carichi di lavoro flessibili e non sensibili al fattore tempo (set). `"service_tier": "flex"` **Reserved ** offre un throughput dedicato con un impegno a termine per carichi di lavoro prevedibili; è impostato a livello di account anziché su richiesta (contatta il team del tuo account AWS per abilitare). Per ulteriori informazioni, consulta [ i livelli di servizio. ](service-tiers-inference.html)
| **Standard** | **Priorità** | **Flex ** | **Riservato ** |
| --- | --- | --- | --- |
|  |  |  |  |
## Disponibilità regionale
***La disponibilità regionale a colpo d'occhio * **
Amazon Bedrock offre tre opzioni di inferenza: ** In-Region ** mantiene le richieste all'interno di una singola regione per garantire una conformità rigorosa, ** le Cross-Region ** rotte geografiche tra le regioni all'interno di un'area geografica (come Stati Uniti, UE e APAC) rispettando la residenza dei dati e le Cross-Region ** rotte ** globali ovunque nel mondo senza vincoli di residenza. Per maggiori dettagli, consulta la pagina. [Disponibilità regionale per modelli](models-region-compatibility.md)
| **Region** | **In-Region** | **Geo ** | **Globale** |
| --- | --- | --- | --- |
| us-east-1(Virginia del Nord) |  |  |  |
| us-east-2(Ohio) |  |  |  |
| us-west-2(Oregon) |  |  |  |
| eu-south-1(Milano) |  |  |  |
| eu-west-1(Irlanda) |  |  |  |
| eu-west-2(Londra) |  |  |  |
| ap-northeast-1(Tokyo) |  |  |  |
| ap-south-1(Mumbai) |  |  |  |
| ap-southeast-2(Sydney) |  |  |  |
| sa-east-1(San Paolo) |  |  |  |
| ap-southeast-3(Giacarta) |  |  |  |
| ap-southeast-4(Melbourne) |  |  |  |
| eu-central-1(Francoforte) |  |  |  |
| eu-north-1(Stoccolma) |  |  |  |
## Quote e limiti
Il tuo AWS account ha delle quote predefinite per mantenere le prestazioni del servizio e garantire un uso appropriato di Amazon Bedrock. Le quote predefinite assegnate a un account potrebbero essere aggiornate in base a fattori regionali, alla cronologia dei pagamenti, all'uso fraudolento, all' and/or approvazione di una richiesta di aumento delle quote. [quotas-increase.html](quotas-increase.html) Per ulteriori informazioni, consulta [Quote per Amazon Bedrock](quotas.md) la documentazione e consulta i [ limiti ](/general/latest/gr/bedrock.html#limits_bedrock) per il modello.
## Codice di esempio
**Passaggio 1 - AWS Account: ** se hai già un AWS account, salta questo passaggio. Se non conosci AWS, crea un account [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) AWS.
**Passaggio 2 - Chiave API: ** accedi alla console [ Amazon Bedrock ](https://console.aws.amazon.com/bedrock/home#/api-keys/long-term/create) e genera una chiave API a lungo termine.
**Passaggio 3 - Scarica l'SDK: ** per utilizzare questa guida introduttiva, devi avere Python già installato. Quindi installa il software pertinente in base alle API che stai utilizzando.
Per le risposte o i completamenti della chat, scegli la scheda OpenAI SDK. Per Invoke o Converse, scegli la scheda Boto3.
------
#### [ OpenAI SDK ]
```
pip install boto3 openai
```
------
#### [ Boto3 ]
```
pip install boto3
```
------
### Fase 4 - Impostazione delle variabili di ambiente
Configura il tuo ambiente per utilizzare la chiave API per l'autenticazione.
Scegli la scheda per l'SDK e l'endpoint.
------
#### [ bedrock-mantle ]
```
OPENAI_API_KEY=""
OPENAI_BASE_URL="https://bedrock-mantle..api.aws/v1"
```
------
#### [ bedrock-runtime ]
```
OPENAI_API_KEY=""
OPENAI_BASE_URL="https://bedrock-runtime..amazonaws.com/openai/v1"
```
------
#### [ Boto3 ]
```
AWS_BEARER_TOKEN_BEDROCK=""
```
------
### Passaggio 5: esegui la tua prima richiesta di inferenza
Salva il file con nome `bedrock-first-request.py`
#### mantello roccioso
Usa le impostazioni della [ Fase 4 - Impostazione delle variabili di ambiente. ](#model-card-openai-gpt-oss-safeguard-20b-sample-code-environment) Scegli la scheda `bedrock-mantle`. La scheda Chat utilizza l'API Chat Completions.
------
#### [ Responses API ]
```
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="openai.gpt-oss-safeguard-20b",
input="Can you explain the features of Amazon Bedrock?"
)
print(response)
```
------
#### [ Chat ]
```
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
model="openai.gpt-oss-safeguard-20b",
messages=[{"role": "user", "content": "Can you explain the features of Amazon Bedrock?"}]
)
print(response)
```
------
#### bedrock-runtime: OpenAI SDK
Usa le impostazioni del [ passaggio 4 - Imposta le variabili di ambiente. ](#model-card-openai-gpt-oss-safeguard-20b-sample-code-environment) Scegli la scheda `bedrock-runtime`. Questo esempio utilizza l'API Chat Completions.
**Nota**
Per chiamare l'API Responses con questo modello, usa`bedrock-mantle`. Non puoi attivarlo`bedrock-runtime`.
```
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
model="openai.gpt-oss-safeguard-20b",
messages=[{"role": "user", "content": "Can you explain the features of Amazon Bedrock?"}]
)
print(response)
```
#### bedrock-runtime: Boto3
Usa le impostazioni Boto3 della Fase 4 - Impostazione delle variabili di ambiente[. ](#model-card-openai-gpt-oss-safeguard-20b-sample-code-environment) Scegli l'API per la tua richiesta.
------
#### [ Invoke API ]
```
import json
import boto3
client = boto3.client('bedrock-runtime', region_name='us-east-1')
response = client.invoke_model(
modelId='openai.gpt-oss-safeguard-20b',
body=json.dumps({
'messages': [{ 'role': 'user', 'content': 'Can you explain the features of Amazon Bedrock?'}],
'max_tokens': 1024
})
)
print(json.loads(response['body'].read()))
```
------
#### [ Converse API ]
```
import boto3
client = boto3.client('bedrock-runtime', region_name='us-east-1')
response = client.converse(
modelId='openai.gpt-oss-safeguard-20b',
messages=[
{
'role': 'user',
'content': [{'text': 'Can you explain the features of Amazon Bedrock?'}]
}
]
)
print(response)
```
------