everyais
← 문서 목록

엔드포인트

응답 생성

POST/v1/responses

모델 불러오는 중…

OpenAI Responses 형식으로 요청합니다. 대화를 서버에 저장하는 기능은 없습니다.

  • 추론 강도는 평면 reasoning_effort로 보냅니다. OpenAI SDK에서는 extra_body={"reasoning_effort":"low","everyais":{"parameter_policy":"strict"}}처럼 넘기세요. 네이티브 reasoning 객체는 400입니다.
  • previous_response_id 같은 대화 저장 필드는 400입니다. 이전 턴은 input에 넣으세요. store는 false만 받습니다.
  • tools, tool_choice, text.format은 Responses 평면 형식과 Chat 형식을 모두 받습니다.
  • 도구를 이어 쓸 때는 응답 output 항목을 reasoning까지 그대로 function_call_output과 함께 돌려보내세요. Gemini의 도구 서명이 reasoning 항목의 encrypted_content에 있습니다.

본문

modelstring필수
모델 ID
inputstring | array필수
문자열, 또는 message / function_call / function_call_output 항목 배열
instructionsstring선택
system 지시문
temperaturenumber선택
0–2
top_pnumber선택
0–1
streamboolean선택
토큰 단위 이벤트 스트리밍
backgroundboolean선택
true면 백그라운드 작업으로 제출하고 바로 queued로 응답합니다
tools / tool_choicearray / string|object선택
Chat과 같은 형식 또는 Responses 평면 형식
reasoning_effortstring선택
low / medium / high / xhigh / max. 모델에 따라 none, minimal도 받습니다
textobject선택
format(Chat의 response_format과 같음), verbosity(low/medium/high, GPT 모델만)
prompt_cache_key / safety_identifierstring선택
GPT 모델만. Chat과 같습니다
userstring선택
최종 사용자 식별자
everyaisobject선택
everyais 옵션(cache, cache_ttl, parameter_policy)

모델 옵션

모델별 지원값은 GET /v1/models의 capabilities, limits, parameter_constraints에 있습니다. 페이지 위쪽에서 모델을 고르면 표로 보입니다. 지원하지 않는 값은 조정되거나 400이 됩니다(파라미터 정책).

  • reasoning_effort를 생략하면 모델의 가장 높은 단계를 씁니다. thinking 예산으로 동작하는 모델은 출력 토큰 상한보다 작은 예산 중 가장 높은 단계를, 공통 단계가 없는 모델은 high를 씁니다.
  • none은 모델이 지원할 때만 추론을 끕니다.
  • 웹 검색, response_format, parallel_tool_calls가 필요하면 Chat을 쓰세요.

GET /v1/responses/{id}

background: true로 제출한 작업을 조회합니다. 대기 코드는 비동기 작업에 있습니다. status는 queued → in_progress → completed / incomplete / failed / cancelled 순서로 바뀌고, 끝나면 Response 전체를 돌려줍니다. 작업이 없거나, 만료됐거나, 다른 키나 사용자의 작업이면 404입니다.

POST /v1/responses/{id}/cancel

queued나 in_progress 작업을 취소하고, 작업에 잡아 둔 크레딧을 돌려줍니다. 이미 끝난 작업은 현재 Response를 그대로 돌려줍니다.

문의접수