소개
GPT 6.1 Terra는 화면 캡처와 문서를 읽고 해당 자료에서 목적에 맞는 초안이나 구조화된 항목을 작성합니다. Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 텍스트 |
| 컨텍스트 윈도우 | 1,050,000 tokens |
| max_tokens 상한 | 128,000 |
핵심 기능 및 하이라이트
일상 업무를 위한 더 가벼운 GPT 6.1
GPT 6.1 Terra는 화면 캡처와 문서를 읽고 해당 자료에서 목적에 맞는 초안이나 구조화된 항목을 작성합니다. Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
계획이 필요 없는 요청을 위한 none 설정
Terra는 none, low, medium, high, xhigh, max를 받으며 직접적인 항목 추출에는 none을 활용합니다. Terra 응답 상한은 기본 4,096토큰이며 최대 128,000까지 설정합니다. none보다 높은 강도에서는 추론도 같은 예산을 사용합니다.
더 큰 이미지를 더 자세히 읽습니다
Terra는 메시지 256개와 도구 정의 128개를 받으며 이 엔드포인트의 이미지별 입력 예산은 37,000토큰으로 설정합니다. Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
같은 1,050,000 토큰 윈도우, 긴 프롬프트용 요금 구간 포함
Terra의 1,050,000토큰 컨텍스트에는 문서, 대화, 답변이 포함되며 출력에 최대 128,000토큰을 확보합니다. Terra에 전달하는 문서 묶음이 입력 272,000토큰을 넘으면 답변을 포함한 요청 전체에 긴 프롬프트 요금을 적용합니다. 대량 전송 전 가격표를 확인해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | Terra의 messages에 화면과 추출 지시를 전달하고 후속 턴에서도 도구 호출 ID를 유지합니다. 1개 이상 · 256개 이하 |
max_tokens | 아니요 | Terra 초안과 추론에 필요한 max_tokens를 설정합니다. 기본값은 4,096이며 최대 128,000까지 허용합니다. |
reasoning_effort | 아니요 | Terra는 none, low, medium, high, xhigh, max를 받으며 직접적인 항목 추출에는 none을 활용합니다. |
stop | 아니요 | Terra는 중단 문자열 하나 또는 최대 네 개를 받으며 추출값에 나올 수 있는 표시는 피하도록 설정합니다. 1자 이상 · 1개 이상 · 4개 이하 |
temperature | 아니요 | Terra의 temperature는 |
top_p | 아니요 | Terra의 |
tools | 아니요 | Terra가 제안할 검색·추출 함수를 설명하고 실제 실행은 앱에서 담당합니다. 128개 이하 |
parallel_tool_calls | 아니요 | 결과가 다른 호출의 조건이 아닌 Terra 검색은 같은 턴에서 여러 개 제안하도록 허용합니다. 기본값: |
tool_choice | 아니요 | Terra 문서 처리에 auto, none, required 또는 지정 함수를 선택합니다. |
response_format | 아니요 | Terra 추출 항목의 JSON 구조를 요청하고 예상 스키마와 대조합니다. |
요금
입력 $1 / 출력 $5 100만 토큰당; 272K 토큰 초과 프롬프트: 입력 $2 / 출력 $7.50
활용 사례
스크린샷을 읽고 변경 사항으로 바꾸기
Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
문서와 양식에서 필드 추출하기
스캔한 양식이나 긴 문서를 전달하고, 정해진 JSON 구조에 맞춰 이름 있는 필드를 요청하세요. 단순한 추출에는 reasoning_effort none 또는 low를 쓰고, 출력은 애플리케이션에서 검증하세요.
일관된 어조로 초안 작성과 다시 쓰기
스타일 가이드와 승인된 예시 몇 개를 Terra에 주고, 답변, 요약, 제품 문구를 요청하세요. 명확하고 자연스러운 글쓰기에 맞춰져 있으며, 보통은 낮은 강도로도 충분합니다.
도구 호출 결과를 빠짐없이 돌려보내기
Terra 추출 항목의 JSON 구조를 요청하고 예상 스키마와 대조합니다.
프롬프트 가이드 및 실전 팁
작업에 따라 강도 고르기
Terra는 none, low, medium, high, xhigh, max를 받으며 직접적인 항목 추출에는 none을 활용합니다.
모델이 볼 이미지 영역 지정하기
이미지를
image_url파트로 추가하고, 표의 세 번째 열처럼 영역을 이름으로 짚어 주세요. 지시문은 이미지 옆에 텍스트로 두고, 이미지가 해상도 때문에 읽지 못하는 작은 글씨에 기대지 마세요.예상 답변 길이에 맞춰
max_tokens설정하기Terra 응답 상한은 기본 4,096토큰이며 최대 128,000까지 설정합니다. none보다 높은 강도에서는 추론도 같은 예산을 사용합니다. Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
도구 호출 결과를 빠짐없이 돌려보내기
도구를 정의했다면, 각 결과를 대응하는 tool_call_id와 함께 tool 메시지로 돌려보내고, 어시스턴트의 tool_calls는 대화 기록에 그대로 남겨 두세요. 인자를 검증한 뒤에 실행하세요.
GPT 6.1 Terra
GPT 6.1 Terra는 화면 캡처와 문서를 읽고 해당 자료에서 목적에 맞는 초안이나 구조화된 항목을 작성합니다.
openai/gpt-6.1-terra/chat
Terra에는 캡처의 대상 영역과 추출할 항목을 지정하고 읽기 어려운 값은 알 수 없음으로 표시하도록 요청합니다.
Terra 응답 상한은 기본 4,096토큰이며 최대 128,000까지 설정합니다. none보다 높은 강도에서는 추론도 같은 예산을 사용합니다.
Terra 추출 작업에서는 앱이 실행할 함수를 정의하고 원래 tool_call_id로 결과를 돌려줍니다. 이 호환 인터페이스는 정의 128개까지 받으며 OpenAI 기본 도구는 Responses를 사용합니다.
Terra에 전달하는 문서 묶음이 입력 272,000토큰을 넘으면 답변을 포함한 요청 전체에 긴 프롬프트 요금을 적용합니다. 대량 전송 전 가격표를 확인해야 합니다.
GPT 6.1 Terra의 이미지 이해와 글쓰기 기능이 제한 없는 NSFW 출력을 뜻하지는 않습니다. 콘텐츠 허용 여부는 모델 규칙에 따릅니다.
GPT 6.1 Terra의 이미지 이해와 글쓰기 기능이 제한 없는 NSFW 출력을 뜻하지는 않습니다. 콘텐츠 허용 여부는 모델 규칙에 따릅니다.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "openai/gpt-6.1-terra/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.