GPT-6.1 Terra에 도달하는 가장 짧은 경로는 Responses API입니다. 그러나 유용한 구현을 위해서는 모델 ID만 필요한 것이 아닙니다. 작업을 정의하고, 추론 수준을 선택하며, 적절한 세부 설정으로 이미지를 제공하고, 출력을 검증하며, 외부 상태를 변경할 수 있는 도구를 제한해야 합니다.

이 튜토리얼은 현재 OpenAI API 규칙과 모델 ID gpt-6.1-terra를 사용합니다. 이는 Terra의 공식 포지셔닝에 부합하므로 시각 검토 워크플로우에 중점을 둡니다.

시작하기 전에

GPT-6.1 Terra에 접근할 수 있는 OpenAI API 프로젝트, 소스 코드 외부에 저장된 API 키, 그리고 최신 OpenAI SDK가 필요합니다. 현재 모델 페이지에서는 무료 요금제가 API를 지원하지 않음을 표시하고 있으므로, ChatGPT 요금제의 접근 권한이 API 접근 권한과 동일하다고 가정하지 말고 프로젝트에서 직접 접근 권한을 확인하십시오.

Python SDK 설치:

pip install --upgrade openai


쉘 또는 키 관리자를 통해 `OPENAI_API_KEY`를 설정하세요. 프로덕션 키를 스크립트, 스크린샷, 저장소 또는 클라이언트 애플리케이션에 붙여넣지 마십시오.

## 기본 텍스트 요청 시작하기

```python
from openai import OpenAI

client = OpenAI()

= client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "중간"},
    instructions=(
        간결한 생산 지침을 작성하세요. 가시적 증거를 구분하세요.
        "추론에 기반하며, 제공된 자료가 부족할 경우 상황을 설명합니다."
    ),
    input="이 댓글 노트를 명확한 다섯 가지 행동 목록으로 변환하세요: ..."
)

.output_text 출력

OpenAI는 직접 모델 요청 및 추론 모델에 Responses API를 사용할 것을 권장합니다. instructions 값은 현재 요청에 적용됩니다. 안정적인 동작 지침을 여기에 두고, 사용자 입력은 구체적인 작업에 집중하도록 하세요.

이미지 분석

Terra는 이미지 입력을 받아 텍스트를 반환합니다. 하나의 Responses 요청에는 텍스트와 이미지 URL이 포함될 수 있습니다:

이 스크립트는 비디오에서 오디오를 추출하는 방법을 보여주기 위한 것입니다

from openai import OpenAI

client = OpenAI()

= client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "중간"},
    input=[{
        "role": "user",
        "content": [
            {
                "type": "input_text",
                "text": (
                    "이 광고 활동 이미지를 검토하세요. 보이는 문제만 보고하세요."
                    "자르기, 텍스트 배치, 대비 및 로고 안전 포함."
                    "각 문제에 대해 가시 영역을 지적하고 수정 방안을 제시하십시오."
                ),
            },
            {
                "type": "input_image",
                "image_url": "https://example.com/asset.jpg",
                "detail": "높음",
            },
        ],
    }],
)

.output_text 출력

지원되는 이미지 형식은 PNG, JPEG, WEBP 및 비애니메이션 GIF를 포함합니다. OpenAI의 시각 가이드는 Base64 데이터 URL도 지원합니다. 이미지는 토큰을 소모하므로 작업에 적합한 해상도와 세부 수준을 사용하세요. 밀도가 높거나 좌표에 민감한 화면의 경우, 지원되는 경우 original이 적합할 수 있으며, 초기 대략적인 검토의 경우 low로 충분할 수 있습니다. 표준화된 설정 전에 현재 모델별 크기 표를 확인하세요.

의식적으로 추론 노력 수준 선택

Terra는 none, low, medium, high, xhigh, max를 지원하며, 기본값은 medium입니다. 처리 강도를 높이면 어려운 작업의 품질이 향상되지만, 지연 시간과 토큰 사용량이 증가합니다.

합리적인 평가 단계는 다음과 같습니다:

none：단순한 추출 또는 분류로, 다단계 추론이 가져오는 가치가 크지 않습니다.
low：일반 검토, 초안 작성 또는 제한된 도구 사용.
medium：혼합된 증거, 판단 또는 다단계 작업; 기본값입니다.
high: 어려운 시각적 차이, 계획 또는 복잡한 예외 처리.
xhigh 및 max: 평가 결과 고가치 작업에 실질적인 이점이 있을 때만 사용합니다.

답변이 실패할 때, 자동으로 노력 수준을 높이지 마십시오. 먼저 프롬프트, 증거, 이미지 품질, 출력 계약 및 검증 로직을 확인하십시오.

요청 구조화 출력

생산 시스템은 알려진 패턴을 사용할 수 있을 때 임의의 텍스트를 파싱해서는 안 됩니다. Terra는 구조화된 출력을 지원합니다. 시각적 품질 검사 패턴에는 카테고리, 증거, 심각도 및 권장 사항을 포함하는 문제 배열이 필요할 수 있습니다.

정확한 SDK 보조 구문은 변경될 수 있으므로, 현재 사용 중인 언어에 대한 "구조화된 출력" 가이드를 따르십시오. 구문과 관계없이 반환된 객체를 검증하고, 필요한 증거가 부족할 때 애플리케이션이 수행해야 할 작업을 정의하십시오. 유효한 JSON 구조라도 부정확한 관찰 결과를 포함할 수 있습니다.

응답 API를 통한 도구 추가

Terra에 나열된 Responses API 도구에는 웹 검색, 파일 검색, 이미지 생성, 코드 인터프리터, 호스팅 셸, 컴퓨터 사용, MCP 등이 포함됩니다. 작업에 필요한 도구만 노출됩니다.

컴퓨터 사용의 경우, 귀하의 애플리케이션은 실행 환경을 실행하거나 연결하여 허용된 작업을 수행하고, 스크린샷을 반환하며, 필요에 따라 세션을 유지해야 합니다. OpenAI의 보안 지침은 다음을 권장합니다:

격리된 브라우저 또는 가상 머신.
사이트 및 작업의 허용 목록.
페이지 텍스트나 스크린샷에 자격 증명 정보가 나타나지 않도록 하세요.
구매, 데이터 전송, 삭제 또는 기타 중대한 작업 전에 사용자 승인을 받아야 합니다.
단계, 시간 및 비용 제한.
모델의 요약을 믿지 말고 저장된 결과를 검증하세요.

페이지 내용을 신뢰할 수 없습니다. 웹페이지는 새로운 권한을 부여하거나 사용자의 지시를 덮어쓸 수 없습니다.

신뢰할 수 있는 시각 검토 루프

안정적인 구현은 관찰과 행동을 분리합니다:

이미지와 좁은 심사 기준을 보냅니다.
각 발견에는 가시적인 증거가 필요합니다.
응답 모드를 확인합니다.
높은 심각도 또는 낮은 증거 발견을 관련자에게 전달합니다.
변경이 허용되는 경우, 필요한 편집 또는 컴퓨터 도구만 노출하십시오.
결과 상태를 캡처하고 검증 프로세스를 실행합니다.
원본 콘텐츠, 제안된 작업, 승인, 출력 및 검토자 결정을 저장합니다.

창의적인 작업의 경우, Terra는 스토리보드 검토를 구조화된 수정 브리핑으로 변환할 수 있습니다. 제작자는 이후 독립적인 이미지, 애니메이션 또는 스토리 제작 도구에서 승인된 브리핑을 적용할 수 있습니다.

일반적인 구현 오류

동영상 파일 직접 보내기

Terra는 네이티브 비디오 입력을 나열하지 않았습니다. 대표 프레임을 추출하고, 필요한 경우 전사 또는 촬영 메타데이터를 제공합니다. 분석이 이러한 자료에 기반한다는 점을 명확히 명시합니다.

자유 형식의 도구 사용 허용

모델에게 광범위한 컴퓨터 접근 권한을 부여하면 불필요한 위험이 발생합니다. 도구, 도메인, 작업 및 데이터를 제한하세요. 결과가 발생하는 지점에서 승인을 요구하세요.

출력을 사실적 근거로 간주

시각 모델이 미세한 세부 사항을 놓치거나 지원되지 않는 관계를 추론할 수 있습니다. 오류의 영향이 큰 경우, 알려진 테스트 케이스와 수동 검토를 사용하십시오.

긴 컨텍스트 가격 책정 무시

Terra의 컨텍스트 창은 105만 토큰이지만, 272,000 입력 토큰을 초과하는 프롬프트는 더 높은 요금으로 청구됩니다. 가능한 한 관련 자료만 검색하시기 바랍니다.

자주 묻는 질문

GPT-6.1 Terra의 채팅 완성 기능을 사용할 수 있나요?

모델 페이지는 Chat Completions를 엔드포인트로 나열하지만, 도구 호출에는 Responses API가 필요하다고 지적합니다. 새로운 도구 사용 구현의 경우 Responses가 적절한 기본 선택입니다.

Terra는 미세 조정을 지원하나요?

현재 모델 페이지는 미세 조정을 지원하지 않는 것으로 표시되어 있습니다. 미세 조정을 중심으로 계획을 세우는 대신 명확한 지침, 검색, 예시, 패턴 및 평가를 사용하십시오.

더 높은 추론 능력으로의 업그레이드를 어떻게 테스트해야 하나요?

두 개 이상의 노력 수준에서 동일한 대표 평가 세트를 실행합니다. 수용된 결과, 지연 시간, 토큰 사용량 및 실패 범주를 비교합니다. 인상적인 예시 하나만으로 판단하지 마십시오.

실행 요약

Responses API를 통해 gpt-6.1-terra를 사용하여 중간 정도의 노력으로 시작하고, 모델에 필요한 증거와 도구만 제공하며 구조와 내용을 검증합니다. 권한, 평가, 검증 및 로깅과 같은 주변 프레임워크의 품질은 모델 선택만큼 중요합니다.

GPT-6.1 Terra 사용 방법: API 설정, 추론 노력 및 도구 호출