← 문서 목록

POST /v1/responses

OpenAI Responses 호환 shim, background 잡 폴링·취소 포함.

OpenAI Responses 호환 — 내부적으로 채팅 요청으로 변환하는 shim 입니다. previous_response_id 같은 stateful 저장은 미지원입니다.

Parameters

ParameterTypeRequiredDescription
modelstringYes모델 ID
inputstring | arrayYes문자열, 또는 message / function_call / function_call_output 항목 배열
instructionsstringNosystem 지시문
max_output_tokensintegerNo최대 출력 토큰
temperaturenumberNo0~2
top_pnumberNo0~1
streambooleanNo토큰 단위 이벤트 스트리밍
backgroundbooleanNotrue 면 비동기 잡으로 제출하고 즉시 queued 응답
tools / tool_choicearray / string|objectNochat 과 동일 형식
reasoning_effortstringNonone / low / medium / high
userstringNo최종 사용자 식별자
everyaisobjectNo게이트웨이 캐싱 옵션

Request

{
  "model": "everyais/claude-opus-5",
  "input": "Hello!",
  "instructions": "Be concise."
}

GET /v1/responses/{id}

background: true 로 제출한 잡의 상태를 폴링합니다.

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1709884800,
  "model": "everyais/claude-opus-5",
  "status": "queued",
  "output": [],
  "error": null,
  "incomplete_details": null,
  "usage": null
}

statusqueuedin_progresscompleted / incomplete / failed / cancelled 로 전이합니다. 완료되면 저장된 전체 Response 본문이 반환됩니다.

잡이 없거나·만료됐거나·다른 키/사용자의 것이면 404 를 반환합니다.

POST /v1/responses/{id}/cancel

queued · in_progress 상태의 잡을 cancelled 로 전환하고 예약된 크레딧을 환불합니다. 이미 종료된 잡은 상태 변경 없이 현재 Response 를 그대로 돌려줍니다.