everyais
← 문서 목록

엔드포인트

응답 생성

POST/v1/responses

모델 불러오는 중…

SDK에서 extra_body={"reasoning_effort":"low","everyais":{"parameter_policy":"strict"}}로 지정하세요. 네이티브 reasoning 객체와 previous_response_id 등 stateful 필드는 400입니다. 평면 function/tool_choice는 Chat 중첩 형식으로 바뀌고, text.format(OpenAI 평면 {"type":"json_schema","name","schema","strict"} 또는 Chat 중첩 형식)은 response_format으로 바뀝니다. store는 false만 받습니다. 도구를 이어 쓸 때는 응답 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 과 동일 형식
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선택
게이트웨이 캐싱 옵션

모델 옵션

선택한 모델에서 되는 값은 위 표에서 확인하세요(API에서는 GET /v1/models의 capabilities·limits·parameter_constraints). 지원하지 않는 값을 보냈을 때 값을 조정하는지 400으로 거부하는지는 모델 선택과 접근 정책의 파라미터 정책을 보세요.

생략은 해당 모델의 최고 effort입니다(수동 thinking 예산 모델은 지정한 출력 토큰 상한보다 작은 예산의 최고 단계). 공용 단계가 없으면 high로 연결합니다. none은 모델이 추가값으로 공개한 경우에만 추론을 끕니다. 웹 검색·response_format·parallel_tool_calls는 Chat에서 사용하세요.

GET /v1/responses/{id}

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

json
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1709884800,
  "model": "everyais/gemini-3-5-flash-lite",
  "status": "queued",
  "output": [],
  "error": null,
  "incomplete_details": null,
  "usage": null
}

status 는 queued → in_progress → completed / incomplete / failed / cancelled 로 전이합니다. 완료되면 저장된 전체 Response 본문이 반환됩니다.

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

POST /v1/responses/{id}/cancel

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

문의접수