--- title: OpenAI Moderations | RunAPI description: 通过 RunAPI 的 OpenAI 兼容 Moderations operation 发送请求。 url: https://runapi.ai/zh-CN/docs/api/openai/moderations.md canonical: https://runapi.ai/zh-CN/docs/api/openai/moderations locale: zh-CN --- > HTML version: https://runapi.ai/zh-CN/docs/api/openai/moderations > Site index for agents: https://runapi.ai/llms.txt # OpenAI Moderations ## 概览 使用兼容模型和对应协议的请求、响应结构调用 RunAPI 的 OpenAI 兼容 Moderations operation。 ### 快速开始 1. 创建 API Key，并将其设置为 RUNAPI_API_KEY。 2. 选择兼容模型，然后发送文档所列的路径参数和 JSON 请求体。 3. 读取此 operation 展示的 JSON 响应或服务器发送事件，并处理协议错误。 ## 端点 POST /v1/moderations 基础 URL: https://runapi.ai Contract 版本: v1 首选身份验证: Authorization: Bearer YOUR_API_TOKEN ## 身份验证载体 RunAPI 接受下列每种载体；生成的示例使用该协议的首选请求头。 - `Authorization: Bearer YOUR_API_TOKEN` (首选) - `x-api-key: YOUR_API_TOKEN` ## 兼容模型 打开模型页可查看当前价格、限流和商业使用详情。 - [omni-moderation-latest](https://runapi.ai/models/openai-moderation) ## 请求 Contract 这里只列出同时具有公共协议与 RunAPI 支持证据的字段；其他 JSON 请求体字段会原样传递。 ### JSON 请求体 必填: `input` ```json { "input": { "description": "Text or mixed text and image content to classify.", "items": { "oneOf": [ { "type": "string" }, { "additionalProperties": true, "type": "object" } ] }, "type": [ "string", "array" ] }, "model": { "description": "RunAPI moderation model identifier; defaults to omni-moderation-latest.", "type": "string" } } ``` ### 请求示例 ```json { "input": [ { "text": "A peaceful landscape.", "type": "text" }, { "image_url": { "url": "https://runapi.ai/icon.png" }, "type": "image_url" } ] } ``` ## 同步响应 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" } ``` ### 示例 ```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 } ] } ``` ## 协议错误：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" } ``` ### 示例 ```json { "error": { "code": null, "message": "input is required", "param": "input", "type": "invalid_request_error" } } ``` ## 生成的代码示例 每个 cURL、JavaScript 和 Python 示例都会发送此 Contract 中经过验证的请求，无需协议专用 SDK。 ### 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 #### 安装 ```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()) ``` ## 相关指南 - [API 身份验证](https://runapi.ai/docs/guides/authentication.md) - [快速开始](https://runapi.ai/docs/guides/llm-api/quickstart.md) --- ## More from RunAPI - [Home](https://runapi.ai/.md) - [模型](https://runapi.ai/zh-CN/models.md) - [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md) - [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md) - [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md) - [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md) - [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md) - [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md) - [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md) - [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md) - [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md) - [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md) - [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md) - [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md) - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [Skills](https://runapi.ai/zh-CN/skills.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [反馈](https://runapi.ai/) - [联系](mailto:support@runapi.ai) - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "TechArticle", "headline": "OpenAI Moderations", "description": "通过 RunAPI 的 OpenAI 兼容 Moderations operation 发送请求。", "url": "https://runapi.ai/zh-CN/docs/api/openai/moderations", "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/api/openai/moderations" } ] ```