Source: https://ailoot.ai/docs/ko/api/responses/ Canonical: https://ailoot.ai/docs/ko/api/responses/ Language: ko [API](https://ailoot.ai/docs/ko/) # Responses [Markdown](https://ailoot.ai/docs/ko/api/responses/index.md) OpenAI의 새 형식입니다. 단일 입력, 타입이 지정된 출력, 도구 및 추론을 제공합니다. Codex CLI가 사용합니다. POST`https://api.ailoot.ai/v1/responses` Responses ```bash curl https://api.ailoot.ai/v1/responses \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.1-sol", "instructions": "간결하게 답해 줘.", "input": "TCP와 UDP는 어떻게 달라?" }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]) resp = client.responses.create( model="gpt-6.1-sol", instructions="간결하게 답해 줘.", input="TCP와 UDP는 어떻게 달라?", ) print(resp.output_text) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY }); const resp = await client.responses.create({ model: "gpt-6.1-sol", instructions: "간결하게 답해 줘.", input: "TCP와 UDP는 어떻게 달라?", }); console.log(resp.output_text); ``` 200 OK ```json { "id": "resp_67f1…", "object": "response", "status": "completed", "model": "gpt-6.1-sol", "output": [ { "type": "message", "role": "assistant", "content": [ { "type": "output_text", "text": "TCP는 전달과 순서를 보장합니다. UDP는 이를 보장하지 않지만 더 빠릅니다…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## 인증 | 매개변수 | 유형 | 필수 | 설명 | | --- | --- | --- | --- | | `Authorization` | header | 필수 | 키 형식: `Bearer sk-…`. 다음 헤더도 사용할 수 있습니다: `x-api-key` 또는 `x-goog-api-key`. | ## 요청 본문 | 매개변수 | 유형 | 필수 | 설명 | | --- | --- | --- | --- | | `model` | string | 필수 | Responses 형식을 지원하는 모델 ID입니다. GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok 등 53개가 카탈로그에 있습니다. Gemini 모델은 이 형식에서 사용할 수 없습니다. | | `input` | string \| array | 필수 | 요청 텍스트 또는 메시지와 콘텐츠 파트(텍스트, 이미지)로 이루어진 배열입니다. | | `instructions` | string | 선택 사항 | 시스템 지침입니다. | | `stream` | boolean | 선택 사항 | SSE 이벤트 스트림이며 마지막 이벤트는 `response.completed`. 유료 텍스트는 비용 계산 후 한 번에 전달됩니다. | | `max_output_tokens` | integer | 선택 사항 | 추론을 포함한 최대 응답 토큰 수입니다. 지정하지 않으면 Ailoot가 4096을 설정합니다(모델 응답 한도가 더 낮으면 그보다 적게 설정). 긴 응답은 한도를 명시하세요. 요청에서 `previous_response_id` 및 내장 도구 `web_search` 또는 `code_interpreter` 를 사용하는 경우에도 새 텍스트 요청에서는 저장된 컨텍스트와 도구 작업을 각각 추정합니다. 전체 입력 윈도 비용으로 자동 전환하지는 않습니다. 이전에 합의된 예약액에는 원래 조건이 그대로 적용됩니다. 출력이 이미지, 영상, 오디오인 경우에는 결과 전체 비용을 예약합니다. 계산한 예약액이 가용 잔액이나 키 한도를 초과하면, 지원되는 모델과 메서드에 한해 Ailoot가 `max_tokens` (`max_output_tokens` 는 Responses에서 사용)의 값을 지불 가능한 범위까지 낮출 수 있습니다. 단, 256토큰 또는 해당 메서드에서 정한 더 높은 최소값보다 낮아지지 않으며, 그 사실을 다음 헤더로 알립니다: `X-Ailoot-Max-Tokens-Capped`. 한도를 줄일 수 있는지는 해당 텍스트 모델과 메서드에 대해 확인합니다. 지원되는 Gemini 텍스트 경로의 네이티브 Gemini 형식과 Anthropic Messages 형식에 적용됩니다; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — Chat Completions 및 Messages 형식에서 적용됩니다(모델이 해당 형식을 지원하는 경우). **출력** — 새 텍스트 요청의 예약액을 계산할 때 일반적인 응답 길이와 합의된 조건을 기준으로 추정합니다. 요청한 한도는 다음 매개변수로 지정합니다: `max_tokens` (`max_output_tokens` 는 Responses에서 사용). 요청한 한도가 예약액 계산에 사용하는 토큰 수와 자동으로 같아지는 것은 아니며, 길이를 확실하게 제한할 수 없는 모델에서는 실제 응답 길이를 보장하지도 않습니다. 초기값 4096은 해당 경로에서만 적용되며, 구체적인 규칙은 모델과 메서드에 따라 달라집니다. | | `reasoning` | object | 선택 사항 | `{"effort": "low" \| "medium" \| "high"}` — 추론 모델용입니다. | | `tools` | array | 선택 사항 | 모델이 호출할 수 있는 함수입니다. | | `text` | object | 선택 사항 | 응답 형식입니다. 예: `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | 선택 사항 | 모델이 지원하는 경우 응답의 무작위성입니다. | ## 응답 | 매개변수 | 유형 | 필수 | 설명 | | --- | --- | --- | --- | | `output` | array | | 응답 구성 요소: 메시지(`message`), 추론, 함수 호출. SDK에서 다음을 사용하면 편리합니다: `output_text`. | | `status` | string | | `completed`, `incomplete` (한도 도달) 또는 `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | 궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.[지원팀에 문의](mailto:support@ailoot.ai) ## Ailoot · 회사와 그 프로젝트 포트폴리오 Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다. 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.