텍스트 모델고급 사용자업데이트
POST/v1/responses
GPT-6.1 Terra
요청 ID gpt-6.1-terra
프로토콜
POST /v1/responses· OpenAI Responses 예시
인증
요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.
Authorization: Bearer YOUR_API_KEY
요청 매개변수
POST /v1/responses
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 gpt-6.1-terra로 설정하세요. |
input | string / object[] | 필수 | 입력 텍스트 또는 순서가 있는 입력 항목 배열입니다. 메시지 항목에는 role과 content를 사용합니다. |
instructions | string | 선택 | 작업과 출력 요구 사항을 지정하는 모델 지침입니다. |
max_output_tokens | integer | 선택 | 출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
store | boolean | 조건부 | 이 필드를 지원하는 경우 false는 나중에 조회하기 위한 응답 저장을 하지 않도록 요청합니다. |
text.format | object | 조건부 | 구조화된 출력은 text.format에 지정합니다. 예를 들어 type: json_schema를 사용할 수 있습니다. 해당 형식을 지원하는 엔드포인트에서만 사용하세요. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
reasoning.effort | string | 조건부 | 요청할 추론 강도입니다. 사용 가능한 단계와 추론을 끌 수 있는지는 모델과 엔드포인트에 따라 다릅니다. |
tools | object[] | 조건부 | 모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다. |
tool_choice | string / object | 조건부 | 도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요. |
요청 예시
API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "gpt-6.1-terra",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
응답 읽기
- OpenAI Responses · 스트리밍 시
response.output_text.delta이벤트의delta를 연결하고 완료 및 실패 이벤트를 처리하세요. SSE
기능 및 제한
streaming· 지원tool_calling· 지원image_input· 공개되지 않음video_input· 미지원