aisplice

API 레퍼런스

Responses

이 엔드포인트의 모델(5)

gpt-5.6-lunagpt-6-astragpt-6-lunagpt-6-sol+1
워크벤치에서 사용해 보기
POST/v1/responses

OpenAI Responses API 형식 — 단일 input 필드, 구조화된 출력 항목, 그리고 지원 모델의 경우 추론 요약.

#요청 파라미터

  • modelstring필수

    /v1/models의 모델 ID. 게이트웨이는 이 값으로 업스트림 제공업체를 결정합니다.

  • inputstring | array필수

    프롬프트: 일반 문자열 또는 input 항목 배열.

  • instructionsstring선택

    시스템 수준 지침으로, system 메시지와 같습니다.

  • streamboolean선택

    JSON 본문 하나 대신 response.* SSE 이벤트를 스트리밍합니다.

  • max_output_tokensinteger선택

    생성 토큰 상한. 사전 차감 한도 추정치의 상한도 됩니다.

  • toolsarray선택

    모델이 호출할 수 있는 함수 선언 — 도구 호출 가이드를 참고하세요.

  • previous_response_idstring선택

    기록을 다시 보내지 않고 이전 응답에 후속 턴을 이어 붙입니다.

#긴 대화 압축하기

POST/v1/responses/compact

압축(compaction)은 계속 다시 보내기엔 너무 길어진 대화를 줄여, 이어서 사용할 짧은 형태로 반환합니다. 코딩 에이전트가 세션이 컨텍스트 한도에 가까워질 때 호출하는 기능입니다.

  • modelstring필수

    압축을 지원하는 모델. 다른 모델은 unsupported_endpoint로 이 경로를 거부합니다.

  • inputarray | string선택

    압축할 대화(Responses input 형식).

  • instructionsstring | array선택

    압축할 때 보존할 내용 — 예: "모든 파일 경로와 결정 사항 유지".

  • previous_response_idstring선택

    전체 기록을 다시 보내지 않고 저장된 응답에서 이어 갑니다.

compacted.json
{
  "id": "resp_…",
  "object": "response",
  "created_at": 1789000000,
  "output": [ /* the compacted conversation */ ],
  "usage": {"input_tokens": 8120, "output_tokens": 240, "total_tokens": 8360}
}

스트리밍 없음, 항상 토큰 기준 과금

압축에는 스트리밍 형식이 없습니다 — 이 요청에는 stream:true가 없습니다. 다른 Responses 호출처럼 읽고 쓰는 토큰 기준으로 과금되므로, 매 턴마다가 아니라 필요할 때만 압축하세요.

#관련 오류

  • 400 invalid_request_error본문 형식이 잘못되었거나 이 모델이 지원하지 않는 파라미터입니다.
  • 401Bearer 토큰이 유효하지 않거나 없습니다. 이 경로에는 error.code가 없으므로 상태 코드로 판단하세요.
  • 402 insufficient_user_quota지갑 잔액이 사전 차감 추정액보다 부족합니다.
  • 429키별 속도 제한입니다. 본문은 비어 있으며 Retry-After만큼 기다리세요. insufficient_user_quota가 포함된 429는 속도 제한이 아니라 일일 지출 한도입니다.
  • 503 model_not_found알 수 없는 모델이거나, 현재 이 모델을 제공하는 정상 채널이 없습니다.

전체 오류 코드 표 →

#요청 예시

curl https://www.aisplice.store/v1/responses \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "input": "Say hello."
  }'

#응답

response.json
{
  "id": "resp_…",
  "object": "response",
  "model": "gpt-5.6-luna",
  "output": [{
    "type": "message",
    "role": "assistant",
    "content": [{"type": "output_text", "text": "Hello!"}]
  }],
  "usage": {"input_tokens": 9, "output_tokens": 3, "total_tokens": 12}
}

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.

이전Chat Completions다음Messages(Anthropic 형식)