Responses

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는 어떻게 달라?"
  }' 

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)

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);

{
  "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 }
}

인증

• Authorizationheader필수

  키 형식: Bearer sk-…. 다음 헤더도 사용할 수 있습니다: x-api-key 또는 x-goog-api-key.

요청 본문

• modelstring필수

  Responses 형식을 지원하는 모델 ID입니다. GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok 등 53개가 카탈로그에 있습니다. Gemini 모델은 이 형식에서 사용할 수 없습니다.

• inputstring | array필수

  요청 텍스트 또는 메시지와 콘텐츠 파트(텍스트, 이미지)로 이루어진 배열입니다.

• instructionsstring선택 사항

  시스템 지침입니다.

• streamboolean선택 사항

  SSE 이벤트 스트림이며 마지막 이벤트는 response.completed. 유료 텍스트는 비용 계산 후 한 번에 전달됩니다.

• max_output_tokensinteger선택 사항

  추론을 포함한 최대 응답 토큰 수입니다. 지정하지 않으면 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은 해당 경로에서만 적용되며, 구체적인 규칙은 모델과 메서드에 따라 달라집니다.

• reasoningobject선택 사항

  {"effort": "low" | "medium" | "high"} — 추론 모델용입니다.

• toolsarray선택 사항

  모델이 호출할 수 있는 함수입니다.

• textobject선택 사항

  응답 형식입니다. 예: {"format": {"type": "json_schema", ...}}.

• temperaturenumber선택 사항

  모델이 지원하는 경우 응답의 무작위성입니다.

응답

• outputarray

  응답 구성 요소: 메시지(message), 추론, 함수 호출. SDK에서 다음을 사용하면 편리합니다: output_text.

• statusstring

  completed, incomplete (한도 도달) 또는 failed.

• usageobject

  input_tokens, output_tokens, total_tokens.