--- title: OpenAI Moderazioni | RunAPI description: Invia una richiesta tramite l'operazione Moderations compatibile con OpenAI di RunAPI. url: https://runapi.ai/it/docs/api/openai/moderations.md canonical: https://runapi.ai/it/docs/api/openai/moderations locale: it --- > Versione HTML: https://runapi.ai/it/docs/api/openai/moderations > Indice del sito per gli agenti: https://runapi.ai/llms.txt # OpenAI Moderazioni ## Panoramica Usa l'operazione Moderations compatibile con OpenAI di RunAPI con un modello compatibile e le forme di richiesta e risposta del protocollo. ### Avvio rapido 1. Crea una Chiave API e impostala come RUNAPI_API_KEY. 2. Scegli un modello compatibile, quindi invia i parametri di percorso e il corpo JSON documentati. 3. Leggi la risposta JSON o gli eventi inviati dal server mostrati per questa operazione e gestisci gli errori di protocollo. ## Endpoint POST /v1/moderations URL di base: https://runapi.ai Versione del contratto: v1 Autenticazione preferita: Authorization: Bearer YOUR_API_TOKEN ## Vettori di autenticazione RunAPI accetta ciascun protocollo elencato di seguito. I campioni generati utilizzano l'header preferito del protocollo. - `Authorization: Bearer YOUR_API_TOKEN` (Preferito) - `x-api-key: YOUR_API_TOKEN` ## Modelli compatibili Apri la pagina di un modello per i prezzi correnti, i limiti di frequenza e i dettagli sull'uso commerciale. - [omni-moderation-latest](https://runapi.ai/it/models/openai-moderation) ## Contratto della richiesta Sono elencati solo i campi con evidenza di supporto sia del protocollo pubblico che di RunAPI. I campi aggiuntivi del corpo JSON vengono trasmessi senza modifiche. ### Corpo JSON Obbligatorio: `input` ```json { "input": { "description": "Testo o contenuto misto di testo e immagini da classificare.", "items": { "oneOf": [ { "type": "string" }, { "additionalProperties": true, "type": "object" } ] }, "type": [ "string", "array" ] }, "model": { "description": "Identificatore del modello di moderazione di RunAPI; valore predefinito: omni-moderation-latest.", "type": "string" } } ``` ### Esempio di richiesta ```json { "input": [ { "text": "A peaceful landscape.", "type": "text" }, { "image_url": { "url": "https://runapi.ai/icon.png" }, "type": "image_url" } ] } ``` ## Risposta sincrona HTTP 200 ### Schema ```json { "additionalProperties": true, "properties": { "id": { "minLength": 1, "type": "string" }, "model": { "minLength": 1, "type": "string" }, "results": { "items": { "additionalProperties": true, "properties": { "categories": { "additionalProperties": true, "type": "object" }, "category_applied_input_types": { "additionalProperties": true, "type": "object" }, "category_scores": { "additionalProperties": true, "type": "object" }, "flagged": { "type": "boolean" } }, "required": [ "flagged", "categories", "category_scores" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "id", "model", "results" ], "type": "object" } ``` ### Esempio ```json { "id": "modr_123", "model": "omni-moderation-latest", "results": [ { "categories": { "sexual": false, "violence": false }, "category_applied_input_types": { "sexual": [ "text", "image" ], "violence": [ "text", "image" ] }, "category_scores": { "sexual": 0.0002, "violence": 0.0001 }, "flagged": false } ] } ``` ## Errore di protocollo: invalid_request HTTP 400 ### Schema ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### Esempio ```json { "error": { "code": null, "message": "input is required", "param": "input", "type": "invalid_request_error" } } ``` ## Esempi di Codice Generati Ogni esempio cURL, JavaScript e Python invia la richiesta validata di questo contratto senza richiedere un SDK specifico per il protocollo. ### curl ```curl curl -X POST https://runapi.ai/v1/moderations \ -H Authorization:\ Bearer\ YOUR_API_TOKEN \ -H Content-Type:\ application/json \ -d \{\"input\":\[\{\"type\":\"text\",\"text\":\"A\ peaceful\ landscape.\"\},\{\"type\":\"image_url\",\"image_url\":\{\"url\":\"https://runapi.ai/icon.png\"\}\}\]\} ``` ### javascript ```javascript const response = await fetch("https://runapi.ai/v1/moderations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ "input": [ { "type": "text", "text": "A peaceful landscape." }, { "type": "image_url", "image_url": { "url": "https://runapi.ai/icon.png" } } ] }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### python #### Installa ```bash pip install requests ``` ```python import requests response = requests.post( "https://runapi.ai/v1/moderations", headers={"Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json"}, json={"input": [{"type": "text", "text": "A peaceful landscape."}, {"type": "image_url", "image_url": {"url": "https://runapi.ai/icon.png"}}]} ) response.raise_for_status() print(response.json()) ``` ## Guide correlate - [Autenticazione](https://runapi.ai/it/docs/guides/authentication.md) - [Guida introduttiva](https://runapi.ai/it/docs/guides/llm-api/quickstart.md) --- ## Altre risorse di RunAPI - [Home](https://runapi.ai/it/.md) - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models) - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Indice del sito per gli agenti](https://runapi.ai/llms.txt) Contatti: contact@runapi.ai ## Dati strutturati ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "TechArticle", "headline": "OpenAI Moderazioni", "description": "Invia una richiesta tramite l'operazione Moderations compatibile con OpenAI di RunAPI.", "url": "https://runapi.ai/it/docs/api/openai/moderations", "mainEntityOfPage": "https://runapi.ai/it/docs/api/openai/moderations" } ] ```