--- title: OpenAI Responses | RunAPI description: RunAPI의 OpenAI 호환 Responses 작업을 통해 요청을 전송합니다. url: https://runapi.ai/ko/docs/api/openai/responses.md canonical: https://runapi.ai/ko/docs/api/openai/responses locale: ko --- > HTML 버전: https://runapi.ai/ko/docs/api/openai/responses > 에이전트용 사이트 색인: https://runapi.ai/llms.txt # OpenAI Responses ## 개요 RunAPI의 OpenAI 호환 Responses 작업을 호환 모델과 프로토콜의 요청 및 응답 형식에 맞게 사용하세요. ### 빠른 시작 1. API 키를 만들고 RUNAPI_API_KEY로 설정합니다. 2. 호환되는 모델을 선택한 후 문서화된 경로 매개변수와 JSON 본문을 전송합니다. 3. 해당 작업에 대한 JSON 응답 또는 서버 전송 이벤트를 읽고 프로토콜 오류를 처리하세요. ## 엔드포인트 POST /v1/responses Base URL: https://runapi.ai 계약 버전: v1 권장 인증 방식: Authorization: Bearer YOUR_API_TOKEN ## 인증 정보 전달 방식 RunAPI는 아래 나열된 각 캐리어를 허용합니다. 생성된 샘플은 프로토콜의 기본 헤더를 사용합니다. - `Authorization: Bearer YOUR_API_TOKEN` (권장) - `x-api-key: YOUR_API_TOKEN` - `x-goog-api-key: YOUR_API_TOKEN` - `?key=YOUR_API_TOKEN` ## 호환 모델 현재 가격, 속도 제한 및 상업적 이용 세부 정보는 모델 페이지를 여십시오. - [claude-fable-5-1](https://runapi.ai/ko/models/claude) - [claude-fable-5](https://runapi.ai/ko/models/claude) - [claude-sonnet-5](https://runapi.ai/ko/models/claude) - [claude-opus-5](https://runapi.ai/ko/models/claude) - [claude-opus-4-8](https://runapi.ai/ko/models/claude) - [claude-opus-4-7](https://runapi.ai/ko/models/claude) - [claude-opus-4-6](https://runapi.ai/ko/models/claude) - [claude-sonnet-4-6](https://runapi.ai/ko/models/claude) - [claude-opus-4-5-20251101](https://runapi.ai/ko/models/claude) - [claude-sonnet-4-5-20250929](https://runapi.ai/ko/models/claude) - [claude-haiku-4-5-20251001](https://runapi.ai/ko/models/claude) - [claude-opus-4-1-20250805](https://runapi.ai/ko/models/claude) - [gpt-5.5](https://runapi.ai/ko/models/gpt) - [gpt-5.5-pro](https://runapi.ai/ko/models/gpt) - [gpt-5.4](https://runapi.ai/ko/models/gpt) - [gpt-5.4-mini](https://runapi.ai/ko/models/gpt) - [gpt-5.4-nano](https://runapi.ai/ko/models/gpt) - [gpt-5.4-pro](https://runapi.ai/ko/models/gpt) - [gpt-5.3-codex](https://runapi.ai/ko/models/gpt) - [gpt-5.3-codex-spark](https://runapi.ai/ko/models/gpt) - [gpt-5.6-luna](https://runapi.ai/ko/models/gpt) - [gpt-5.6-sol](https://runapi.ai/ko/models/gpt) - [gpt-5.6-terra](https://runapi.ai/ko/models/gpt) - [gpt-6-astra](https://runapi.ai/ko/models/gpt) - [gemini-3.6-flash](https://runapi.ai/ko/models/gemini) - [gemini-3.5-flash](https://runapi.ai/ko/models/gemini) - [gemini-3.1-pro-preview](https://runapi.ai/ko/models/gemini) - [gemini-3-flash-preview](https://runapi.ai/ko/models/gemini) - [gemini-2.5-pro](https://runapi.ai/ko/models/gemini) - [gemini-2.5-flash](https://runapi.ai/ko/models/gemini) - [deepseek-v4-flash-vision-exp](https://runapi.ai/ko/models/deepseek) - [deepseek-v4-pro](https://runapi.ai/ko/models/deepseek) - [deepseek-v4-flash](https://runapi.ai/ko/models/deepseek) - [glm-5.2](https://runapi.ai/ko/models/glm) - [glm-5.1](https://runapi.ai/ko/models/glm) - [glm-5-turbo](https://runapi.ai/ko/models/glm) - [glm-5](https://runapi.ai/ko/models/glm) - [glm-4.7](https://runapi.ai/ko/models/glm) - [glm-4.6](https://runapi.ai/ko/models/glm) - [glm-4.5](https://runapi.ai/ko/models/glm) - [glm-4.5-air](https://runapi.ai/ko/models/glm) - [kimi-k3](https://runapi.ai/ko/models/kimi) - [kimi-k2.7-code](https://runapi.ai/ko/models/kimi) - [kimi-k2.6](https://runapi.ai/ko/models/kimi) - [kimi-k2.5](https://runapi.ai/ko/models/kimi) - [MiniMax-M3](https://runapi.ai/ko/models/minimax) - [MiniMax-M2.7](https://runapi.ai/ko/models/minimax) - [MiniMax-M2.7-highspeed](https://runapi.ai/ko/models/minimax) - [MiniMax-M2.5](https://runapi.ai/ko/models/minimax) - [MiniMax-M2.5-highspeed](https://runapi.ai/ko/models/minimax) - [MiniMax-M2.1](https://runapi.ai/ko/models/minimax) - [MiniMax-M2](https://runapi.ai/ko/models/minimax) - [mimo-v2.5-pro](https://runapi.ai/ko/models/mimo) - [mimo-v2.5](https://runapi.ai/ko/models/mimo) - [grok-4.20-0309-non-reasoning](https://runapi.ai/ko/models/grok) - [grok-4.6](https://runapi.ai/ko/models/grok) - [grok-4.5](https://runapi.ai/ko/models/grok) - [grok-4.3](https://runapi.ai/ko/models/grok) ## 요청 계약 공개 프로토콜과 RunAPI 지원이 모두 확인된 필드만 나열됩니다. 추가 JSON 본문 필드는 그대로 전달됩니다. ### JSON 본문 필수: `model` ```json { "input": { "description": "모델에 제공되는 텍스트, 메시지 항목 또는 도구 결과.", "type": [ "string", "array" ] }, "instructions": { "description": "이 응답에 대한 시스템 또는 개발자 지침.", "type": [ "string", "null" ] }, "max_output_tokens": { "description": "표시 토큰과 추론 토큰을 포함한 최대 출력 토큰 수.", "type": [ "integer", "null" ] }, "model": { "description": "호환 가능한 모델 카탈로그가 반환하는 RunAPI 모델 식별자.", "type": "string" }, "moderation": { "additionalProperties": true, "description": "현재 입력과 완전한 출력에 대한 독립적인 모더레이션 신호를 반환합니다.", "properties": { "model": { "enum": [ "omni-moderation-latest" ], "type": "string" }, "policy": { "additionalProperties": true, "properties": { "input": { "additionalProperties": true, "properties": { "mode": { "enum": [ "score", "block" ], "type": "string" } }, "required": [ "mode" ], "type": [ "object", "null" ] }, "output": { "additionalProperties": true, "properties": { "mode": { "enum": [ "score", "block" ], "type": "string" } }, "required": [ "mode" ], "type": [ "object", "null" ] } }, "type": [ "object", "null" ] } }, "required": [ "model" ], "type": [ "object", "null" ] }, "stream": { "default": false, "description": "타입이 지정된 Responses 이벤트를 서버 전송 이벤트로 반환합니다.", "type": [ "boolean", "null" ] }, "tools": { "description": "모델이 호출할 수 있는 도구.", "type": "array" } } ``` ### 요청 예시 ```json { "input": "Summarize one practical improvement for an API deployment.", "model": "gpt-5.4", "moderation": { "model": "omni-moderation-latest", "policy": { "input": { "mode": "score" }, "output": { "mode": "block" } } } } ``` ## 동기 응답 HTTP 200 ### 스키마 ```json { "additionalProperties": true, "properties": { "id": { "type": "string" }, "model": { "type": "string" }, "moderation": { "additionalProperties": true, "properties": { "input": { "oneOf": [ { "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" }, "model": { "const": "omni-moderation-latest", "type": "string" }, "type": { "const": "moderation_result", "type": "string" } }, "required": [ "type", "model", "flagged", "categories", "category_scores", "category_applied_input_types" ], "type": "object" }, { "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "const": "error", "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" } ] }, "output": { "oneOf": [ { "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" }, "model": { "const": "omni-moderation-latest", "type": "string" }, "type": { "const": "moderation_result", "type": "string" } }, "required": [ "type", "model", "flagged", "categories", "category_scores", "category_applied_input_types" ], "type": "object" }, { "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "const": "error", "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" } ] } }, "required": [ "input", "output" ], "type": "object" }, "object": { "const": "response", "type": "string" }, "output": { "type": "array" }, "status": { "type": "string" }, "usage": { "additionalProperties": true, "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "type": "object" } }, "required": [ "id", "object", "status", "model", "output" ], "type": "object" } ``` ### 예시 ```json { "id": "resp_example", "model": "gpt-5.4", "moderation": { "input": { "categories": { "sexual": false, "violence": true }, "category_applied_input_types": { "sexual": [ "text" ], "violence": [ "text" ] }, "category_scores": { "sexual": 0.0002, "violence": 0.96 }, "flagged": true, "model": "omni-moderation-latest", "type": "moderation_result" }, "output": { "categories": { "sexual": false, "violence": false }, "category_applied_input_types": { "sexual": [ "text" ], "violence": [ "text" ] }, "category_scores": { "sexual": 0.0002, "violence": 0.0001 }, "flagged": false, "model": "omni-moderation-latest", "type": "moderation_result" } }, "object": "response", "output": [ { "content": [ { "annotations": [], "text": "Hello! How can I help today?", "type": "output_text" } ], "id": "msg_example", "role": "assistant", "status": "completed", "type": "message" } ], "status": "completed", "usage": { "input_tokens": 12, "output_tokens": 8, "total_tokens": 20 } } ``` ## SSE 이벤트: output_text_delta 미디어 유형: `text/event-stream` ### 스키마 ```json { "additionalProperties": true, "properties": { "content_index": { "type": "integer" }, "delta": { "type": "string" }, "item_id": { "type": "string" }, "output_index": { "type": "integer" }, "type": { "const": "response.output_text.delta", "type": "string" } }, "required": [ "type", "item_id", "output_index", "content_index", "delta" ], "type": "object" } ``` ### 예시 ```json { "content_index": 0, "delta": "Hello", "item_id": "msg_example", "output_index": 0, "type": "response.output_text.delta" } ``` ## SSE 이벤트: completed 미디어 유형: `text/event-stream` ### 스키마 ```json { "additionalProperties": true, "properties": { "response": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "model": { "type": "string" }, "moderation": { "additionalProperties": true, "properties": { "input": { "oneOf": [ { "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" }, "model": { "const": "omni-moderation-latest", "type": "string" }, "type": { "const": "moderation_result", "type": "string" } }, "required": [ "type", "model", "flagged", "categories", "category_scores", "category_applied_input_types" ], "type": "object" }, { "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "const": "error", "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" } ] }, "output": { "oneOf": [ { "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" }, "model": { "const": "omni-moderation-latest", "type": "string" }, "type": { "const": "moderation_result", "type": "string" } }, "required": [ "type", "model", "flagged", "categories", "category_scores", "category_applied_input_types" ], "type": "object" }, { "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "const": "error", "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" } ] } }, "required": [ "input", "output" ], "type": "object" }, "object": { "const": "response", "type": "string" }, "output": { "type": "array" }, "status": { "type": "string" }, "usage": { "additionalProperties": true, "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "type": "object" } }, "required": [ "id", "object", "status", "model", "output", "usage" ], "type": "object" }, "type": { "const": "response.completed", "type": "string" } }, "required": [ "type", "response" ], "type": "object" } ``` ### 예시 ```json { "response": { "id": "resp_example", "model": "gpt-5.4", "moderation": { "input": { "categories": { "sexual": false, "violence": true }, "category_applied_input_types": { "sexual": [ "text" ], "violence": [ "text" ] }, "category_scores": { "sexual": 0.0002, "violence": 0.96 }, "flagged": true, "model": "omni-moderation-latest", "type": "moderation_result" }, "output": { "categories": { "sexual": false, "violence": false }, "category_applied_input_types": { "sexual": [ "text" ], "violence": [ "text" ] }, "category_scores": { "sexual": 0.0002, "violence": 0.0001 }, "flagged": false, "model": "omni-moderation-latest", "type": "moderation_result" } }, "object": "response", "output": [ { "content": [ { "annotations": [], "text": "Hello! How can I help today?", "type": "output_text" } ], "id": "msg_example", "role": "assistant", "status": "completed", "type": "message" } ], "status": "completed", "usage": { "input_tokens": 12, "output_tokens": 8, "total_tokens": 20 } }, "type": "response.completed" } ``` ## 프로토콜 오류: invalid_request HTTP 400 ### 스키마 ```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 must be a string or an array", "param": "input", "type": "invalid_request_error" } } ``` ## 사용량 ### 스키마 ```json { "additionalProperties": true, "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "type": "object" } ``` ### 예시 ```json { "input_tokens": 12, "output_tokens": 8, "total_tokens": 20 } ``` ## 생성된 코드 샘플 각 cURL, JavaScript, Python 예제는 프로토콜별 SDK 없이도 이 계약에서 검증된 요청을 전송합니다. ### curl ```curl curl -X POST https://runapi.ai/v1/responses \ -H Authorization:\ Bearer\ YOUR_API_TOKEN \ -H Content-Type:\ application/json \ -d \{\"model\":\"gpt-5.4\",\"input\":\"Summarize\ one\ practical\ improvement\ for\ an\ API\ deployment.\",\"moderation\":\{\"model\":\"omni-moderation-latest\",\"policy\":\{\"input\":\{\"mode\":\"score\"\},\"output\":\{\"mode\":\"block\"\}\}\}\} ``` ### javascript ```javascript const response = await fetch("https://runapi.ai/v1/responses", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "gpt-5.4", "input": "Summarize one practical improvement for an API deployment.", "moderation": { "model": "omni-moderation-latest", "policy": { "input": { "mode": "score" }, "output": { "mode": "block" } } } }) }); 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/responses", headers={"Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json"}, json={"model": "gpt-5.4", "input": "Summarize one practical improvement for an API deployment.", "moderation": {"model": "omni-moderation-latest", "policy": {"input": {"mode": "score"}, "output": {"mode": "block"}}}} ) response.raise_for_status() print(response.json()) ``` ## 관련 가이드 - [인증](https://runapi.ai/ko/docs/guides/authentication.md) - [빠른 시작](https://runapi.ai/ko/docs/guides/llm-api/quickstart.md) --- ## RunAPI의 더 많은 정보 - [홈](https://runapi.ai/ko/.md) - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models) - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [에이전트용 사이트 색인](https://runapi.ai/llms.txt) 문의: contact@runapi.ai ## 구조화된 데이터 ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "TechArticle", "headline": "OpenAI Responses", "description": "RunAPI의 OpenAI 호환 Responses 작업을 통해 요청을 전송합니다.", "url": "https://runapi.ai/ko/docs/api/openai/responses", "mainEntityOfPage": "https://runapi.ai/ko/docs/api/openai/responses" } ] ```