curl -X POST https://aireiter.com/api/v1/responses \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": true }'
from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://aireiter.com/api/v1")response = client.responses.create( model="claude-sonnet-4-5-20250929", input="Write a one-sentence bedtime story about a unicorn.")print(response.output_text)
import OpenAI from "openai";const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://aireiter.com/api/v1",});const response = await client.responses.create({ model: "claude-sonnet-4-5-20250929", input: "Write a one-sentence bedtime story about a unicorn.",});console.log(response.output_text);
package mainimport ( "bytes" "encoding/json" "fmt" "net/http")func main() { payload := map[string]interface{}{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false, } body, _ := json.Marshal(payload) req, _ := http.NewRequest("POST", "https://aireiter.com/api/v1/responses", bytes.NewBuffer(body)) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var result map[string]interface{} json.NewDecoder(resp.Body).Decode(&result) fmt.Println(result)}
import com.fasterxml.jackson.databind.ObjectMapper;import java.net.URI;import java.net.http.*;import java.util.Map;public class ResponsesExample { public static void main(String[] args) throws Exception { var payload = Map.of( "model", "claude-sonnet-4-5-20250929", "input", "Write a one-sentence bedtime story about a unicorn.", "stream", false ); var body = new ObjectMapper().writeValueAsString(payload); var request = HttpRequest.newBuilder() .uri(URI.create("https://aireiter.com/api/v1/responses")) .header("Authorization", "Bearer YOUR_API_KEY") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); }}
<?php$client = new GuzzleHttp\Client();$response = $client->post('https://aireiter.com/api/v1/responses', [ 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ], 'json' => [ 'model' => 'claude-sonnet-4-5-20250929', 'input' => 'Write a one-sentence bedtime story about a unicorn.', 'stream' => false, ],]);echo $response->getBody();
require 'net/http'require 'json'uri = URI('https://aireiter.com/api/v1/responses')req = Net::HTTP::Post.new(uri, { 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json'})req.body = { model: 'claude-sonnet-4-5-20250929', input: 'Write a one-sentence bedtime story about a unicorn.', stream: false}.to_jsonres = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }puts res.body
import Foundationlet payload: [String: Any] = [ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false]var request = URLRequest(url: URL(string: "https://aireiter.com/api/v1/responses")!)request.httpMethod = "POST"request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")request.setValue("application/json", forHTTPHeaderField: "Content-Type")request.httpBody = try! JSONSerialization.data(withJSONObject: payload)URLSession.shared.dataTask(with: request) { data, _, _ in if let data = data { print(String(data: data, encoding: .utf8)!) }}.resume()
using System.Net.Http;using System.Net.Http.Json;var client = new HttpClient();client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");var response = await client.PostAsJsonAsync("https://aireiter.com/api/v1/responses", new { model = "claude-sonnet-4-5-20250929", input = "Write a one-sentence bedtime story about a unicorn.", stream = false});Console.WriteLine(await response.Content.ReadAsStringAsync());
OpenAI Responses API 프로토콜과 호환되며, 텍스트 대화, 이미지 이해, 도구 호출, 구조화 출력 및 추론 모드를 지원합니다.
주로 Codex CLI 및 AI SDK와 같은 도구에서 사용됩니다.
POST
/
api
/
v1
/
responses
curl -X POST https://aireiter.com/api/v1/responses \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": true }'
from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://aireiter.com/api/v1")response = client.responses.create( model="claude-sonnet-4-5-20250929", input="Write a one-sentence bedtime story about a unicorn.")print(response.output_text)
import OpenAI from "openai";const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://aireiter.com/api/v1",});const response = await client.responses.create({ model: "claude-sonnet-4-5-20250929", input: "Write a one-sentence bedtime story about a unicorn.",});console.log(response.output_text);
package mainimport ( "bytes" "encoding/json" "fmt" "net/http")func main() { payload := map[string]interface{}{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false, } body, _ := json.Marshal(payload) req, _ := http.NewRequest("POST", "https://aireiter.com/api/v1/responses", bytes.NewBuffer(body)) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var result map[string]interface{} json.NewDecoder(resp.Body).Decode(&result) fmt.Println(result)}
import com.fasterxml.jackson.databind.ObjectMapper;import java.net.URI;import java.net.http.*;import java.util.Map;public class ResponsesExample { public static void main(String[] args) throws Exception { var payload = Map.of( "model", "claude-sonnet-4-5-20250929", "input", "Write a one-sentence bedtime story about a unicorn.", "stream", false ); var body = new ObjectMapper().writeValueAsString(payload); var request = HttpRequest.newBuilder() .uri(URI.create("https://aireiter.com/api/v1/responses")) .header("Authorization", "Bearer YOUR_API_KEY") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); }}
<?php$client = new GuzzleHttp\Client();$response = $client->post('https://aireiter.com/api/v1/responses', [ 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ], 'json' => [ 'model' => 'claude-sonnet-4-5-20250929', 'input' => 'Write a one-sentence bedtime story about a unicorn.', 'stream' => false, ],]);echo $response->getBody();
require 'net/http'require 'json'uri = URI('https://aireiter.com/api/v1/responses')req = Net::HTTP::Post.new(uri, { 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json'})req.body = { model: 'claude-sonnet-4-5-20250929', input: 'Write a one-sentence bedtime story about a unicorn.', stream: false}.to_jsonres = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }puts res.body
import Foundationlet payload: [String: Any] = [ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false]var request = URLRequest(url: URL(string: "https://aireiter.com/api/v1/responses")!)request.httpMethod = "POST"request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")request.setValue("application/json", forHTTPHeaderField: "Content-Type")request.httpBody = try! JSONSerialization.data(withJSONObject: payload)URLSession.shared.dataTask(with: request) { data, _, _ in if let data = data { print(String(data: data, encoding: .utf8)!) }}.resume()
using System.Net.Http;using System.Net.Http.Json;var client = new HttpClient();client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");var response = await client.PostAsJsonAsync("https://aireiter.com/api/v1/responses", new { model = "claude-sonnet-4-5-20250929", input = "Write a one-sentence bedtime story about a unicorn.", stream = false});Console.WriteLine(await response.Content.ReadAsStringAsync());
시스템 프롬프트(System Prompt). 모델의 행동 규칙, 역할 정체성 또는 컨텍스트 배경을 설정하는 데 사용됩니다.메시지 배열 내 role: "system" 메시지와 동등합니다.
boolean
기본값:"true"
스트리밍 출력 활성화 여부.
true(기본): SSE 이벤트 스트림 방식으로 토큰별 반환, 실시간 표시 적합
false: 완전한 응답 대기 후 일괄 반환, 일괄 처리 적합
integer
생성할 응답의 최대 토큰 수. 제한을 초과하면 응답 status 가 "incomplete" 로, incomplete_details.reason 가 "max_output_tokens" 로 설정됩니다.
number
샘플링 온도, 범위는 0 ~ 2. 값이 높을수록 출력이 더 무작위적이며, 값이 낮을수록 출력을 더 결정론적으로 만듭니다. temperature 와 top_p 를 동시에 수정하는 것은 권장하지 않습니다.
number
핵심 샘플링 확률, 범위는 0 ~ 1. 모델은 누적 확률이 top_p 에 도달한 토큰들만 샘플링합니다.
array
모델이 호출할 수 있는 도구 목록. 현재는 type: "function" 유형만 지원하며, web_search, file_search, computer_use 등 내장 도구는 지원하지 않습니다.
표시 function 도구 형식
string
필수
고정값 "function"
string
필수
함수 이름, 정규표현식 ^[a-zA-Z0-9_-]{1,64}$ 를 준수해야 합니다.
string
함수 설명, 모델이 언제 이 도구를 호출할지 판단하는 데 도움을 줍니다.
object
파라미터 정의, JSON Schema 형식 준수
string | object
기본값:"auto"
도구 호출 전략:
"auto": 모델이 자동으로 도구 호출 여부 결정
"none": 도구 호출 금지
"required": 최소 하나 이상의 도구 호출 강제
{ "type": "function", "name": "function_name" }: 지정된 도구 호출 강제
boolean
기본값:"true"
모델이 여러 도구를 병렬로 호출할지 여부. tools 제공 시에만 유효합니다.
object
출력 형식 제어.
표시 text 객체
object
표시 format 객체
string
필수
출력 형식 유형:
"text": 일반 텍스트(기본값)
"json_object": JSON 형식
"json_schema": 지정된 스키마를 준수하는 JSON
string
스키마 이름(json_schema 일 때만 유효)
string
스키마 설명(json_schema 일 때만 유효)
boolean
기본값:"true"
스키마 엄격 준수 여부(json_schema 일 때만 유효)
object
JSON 스키마 정의(json_schema 일 때 필수)
object
추론 모드 설정(gpt-5.2 이상 등 추론 지원 모델에 적용).
표시 reasoning 객체
string
추론 강도: "low" | "medium" | "high"
응답 필드
string
응답 고유 식별자, 형식: resp_ + 24자리 임의 문자열
string
고정값 "response"
number
응답 생성 시간, Unix 타임스탬프(초, 밀리초 정밀도 포함)
string
응답 상태:
"completed": 정상 완료
"incomplete": max_output_tokens로 인한 조기 종료
"in_progress": 스트리밍 출력 진행 중(스트리밍 이벤트에서만 나타남)
"failed": 생성 실패
string
실제 사용된 모델 이름
string
플랫폼 확장 필드. 이번 호출의 청구 작업 ID로, 결산 및 소모 조회에 사용 가능.주의:
비스트리밍: task_id가 응답 JSON 최상위에 직접 위치
스트리밍: task_id가 response.created(첫 이벤트) 및 response.completed(마지막 이벤트)의 response 객체 안에 중첩, 원본 SSE 이벤트를 파싱해 획득해야 하며, OpenAI SDK의 스트리밍 인터페이스는 이 필드를 자동으로 노출하지 않음
array
출력 내용 배열로, 텍스트 메시지와 도구 호출 두 가지 유형을 포함할 수 있음.
표시 message 타입
string
메시지 ID, 형식: msg_ + 16자리 임의 문자열
string
고정값 "message"
string
고정값 "assistant"
string
"completed" | "in_progress"
array
내용 블록 배열:
표시 output_text 내용 블록
string
고정값 "output_text"
string
모델이 생성한 텍스트 내용
array
텍스트 주석, 일반적으로 빈 배열 []
표시 function_call 타입
string
도구 호출 항목 ID, 형식: fc_ + 16자리 임의 문자열
string
고정값 "function_call"
string
도구 호출 ID, 도구 실행 결과 제출 시 참조용
string
호출된 함수 이름
string
함수 파라미터, JSON 직렬화된 문자열
string
편리 필드, output[0].content[0].text와 동일(순수 텍스트 시나리오). 도구 호출 시에는 빈 문자열.
object
토큰 사용량 통계.
표시 usage 객체
integer
입력 토큰 수(system prompt 포함)
integer
출력 토큰 수
integer
총 토큰 수 = 입력 + 출력
object
표시 상세 정보
integer
추론/사고 토큰 수(일반 모델은 0)
object | null
status가 "incomplete"일 때 null이 아님.
표시 incomplete_details 객체
string
잘린 이유. 현재는 "max_output_tokens"뿐임
curl -X POST https://aireiter.com/api/v1/responses \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": true }'
from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://aireiter.com/api/v1")response = client.responses.create( model="claude-sonnet-4-5-20250929", input="Write a one-sentence bedtime story about a unicorn.")print(response.output_text)
import OpenAI from "openai";const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://aireiter.com/api/v1",});const response = await client.responses.create({ model: "claude-sonnet-4-5-20250929", input: "Write a one-sentence bedtime story about a unicorn.",});console.log(response.output_text);
package mainimport ( "bytes" "encoding/json" "fmt" "net/http")func main() { payload := map[string]interface{}{ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false, } body, _ := json.Marshal(payload) req, _ := http.NewRequest("POST", "https://aireiter.com/api/v1/responses", bytes.NewBuffer(body)) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var result map[string]interface{} json.NewDecoder(resp.Body).Decode(&result) fmt.Println(result)}
import com.fasterxml.jackson.databind.ObjectMapper;import java.net.URI;import java.net.http.*;import java.util.Map;public class ResponsesExample { public static void main(String[] args) throws Exception { var payload = Map.of( "model", "claude-sonnet-4-5-20250929", "input", "Write a one-sentence bedtime story about a unicorn.", "stream", false ); var body = new ObjectMapper().writeValueAsString(payload); var request = HttpRequest.newBuilder() .uri(URI.create("https://aireiter.com/api/v1/responses")) .header("Authorization", "Bearer YOUR_API_KEY") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body)) .build(); var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); }}
<?php$client = new GuzzleHttp\Client();$response = $client->post('https://aireiter.com/api/v1/responses', [ 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ], 'json' => [ 'model' => 'claude-sonnet-4-5-20250929', 'input' => 'Write a one-sentence bedtime story about a unicorn.', 'stream' => false, ],]);echo $response->getBody();
require 'net/http'require 'json'uri = URI('https://aireiter.com/api/v1/responses')req = Net::HTTP::Post.new(uri, { 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json'})req.body = { model: 'claude-sonnet-4-5-20250929', input: 'Write a one-sentence bedtime story about a unicorn.', stream: false}.to_jsonres = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }puts res.body
import Foundationlet payload: [String: Any] = [ "model": "claude-sonnet-4-5-20250929", "input": "Write a one-sentence bedtime story about a unicorn.", "stream": false]var request = URLRequest(url: URL(string: "https://aireiter.com/api/v1/responses")!)request.httpMethod = "POST"request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")request.setValue("application/json", forHTTPHeaderField: "Content-Type")request.httpBody = try! JSONSerialization.data(withJSONObject: payload)URLSession.shared.dataTask(with: request) { data, _, _ in if let data = data { print(String(data: data, encoding: .utf8)!) }}.resume()
using System.Net.Http;using System.Net.Http.Json;var client = new HttpClient();client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");var response = await client.PostAsJsonAsync("https://aireiter.com/api/v1/responses", new { model = "claude-sonnet-4-5-20250929", input = "Write a one-sentence bedtime story about a unicorn.", stream = false});Console.WriteLine(await response.Content.ReadAsStringAsync());
from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://aireiter.com/api/v1")response = client.responses.create( model="claude-sonnet-4-5-20250929", instructions="You are a helpful coding assistant.", input="How do I reverse a string in Python?",)print(response.output_text)
response = client.responses.create( model="claude-3-7-sonnet-20250219", # 추론이 지원되는 모델 input="Solve: If x + y = 10 and x * y = 21, what are x and y?", reasoning={"effort": "high"},)print(response.output_text)
다회차 대화
previous_response_id는 현재 작동하지 않으며, 히스토리 메시지를 input에 직접 연결해야 합니다:
# 첫 번째 라운드response1 = client.responses.create( model="claude-sonnet-4-5-20250929", input="My name is Bob.",)# 두 번째 라운드: 수동으로 히스토리 메시지 연결response2 = client.responses.create( model="claude-sonnet-4-5-20250929", input=[ {"role": "user", "content": "My name is Bob."}, {"role": "assistant", "content": response1.output_text}, {"role": "user", "content": "What's my name?"}, ],)print(response2.output_text) # "Your name is Bob."
주의사항
기본값은 스트리밍:stream 매개변수의 기본값은 true입니다. 비스트리밍 응답이 필요할 경우 명시적으로 "stream": false를 전달해야 합니다.
포인트 부족:잔액이 부족할 경우 HTTP 402가 반환되며, 충전 후 다시 시도하시기 바랍니다.
text.format 지원 제한:현재 기본 공급자는 구조화된 출력 지원이 제한적입니다 — json_object 모드에서는 모델이 여전히 순수 JSON 대신 Markdown 코드 블록을 출력할 수 있으며, json_schema 모드에서는 스키마 제약이 준수되지 않을 수 있습니다. 구조화된 출력을 원할 경우 instructions 또는 input에 원하는 형식을 명확하게 기술하시기 바랍니다.