> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT-6.1 Terra 이용 가능

> GPT-6.1 Terra가 이제 APIYI에 등록되었으며, 기본 입력 요금은 백만 token당 $1, 출력 요금은 $5입니다. 시각적 추론에 중점을 둔 기능, 1.05M 컨텍스트 윈도우, 추론 수준, API 예시, 과금 경계를 살펴보세요.

## 핵심 요점

* **APIYI에 새로 등록**: 모델 ID는 `gpt-6.1-terra`입니다. 표준 입력 비용은 \$1, 출력 비용은 \$5, 캐시 읽기 비용은 토큰 100만 개당 \$0.05로, OpenAI의 해당 표준 요율과 동일합니다.
* **시각 및 텍스트 작업**: OpenAI는 이 모델을 제품 이미지 매칭, 기술 도면 해석, 화면 상호작용, 텍스트 수정에 사용하도록 제시합니다. 이미지를 입력받고 텍스트를 생성합니다.
* **1.05M 컨텍스트 윈도우**: 공식 컨텍스트 윈도우는 1,050,000토큰이며, 최대 출력은 128,000토큰입니다. 용량 제한과 긴 컨텍스트에 대한 과금은 별도로 고려해야 합니다.
* **추론 비활성화 가능**: 사용 가능한 수준은 `none`, `low`, `medium`, `high`, `xhigh`, `max`입니다. 기본값은 `medium`입니다.
* **도구에는 Responses 사용**: 아래 두 API 예제는 일반 텍스트 요청을 다룹니다. 함수 도구를 통합할 때는 `/v1/responses`을 사용합니다.

## 출시 배경 및 포지셔닝

OpenAI는 2026년 10월 26일 API 변경 로그에서 GPT-6.1 Terra를 발표했습니다. 10월 27일 공식 문서와 APIYI의 공개 가격 엔드포인트를 확인한 결과, 모델이 플랫폼의 모델 목록에 추가된 것을 확인했으며, 이어서 아래 기능 점검을 완료했습니다.

Terra는 시각적 추론, 컴퓨터 상호작용, 자연스러운 텍스트 표현에 중점을 둡니다. 개발자는 기존 워크플로의 특정 단계 하나에 적용해 보는 것부터 시작할 수 있습니다. 예를 들어 제품 이미지와 카탈로그 레코드 매칭, 기술 도면의 주석 해석, 스크린샷을 통한 인터페이스 상태 식별, 기존 초안 수정 등이 있습니다.

이는 OpenAI가 설명한 작업 분야이며, 비즈니스 요구사항에 맞는지는 여전히 검증해야 합니다. 자체 샘플을 사용해 스크린샷 정확도, 수정된 텍스트의 의미 보존, 도구 인수의 신뢰성을 테스트하십시오. 이 문서에서는 재현하지 않은 성능 순위나 속도 배수를 제시하지 않습니다.

## 사양 및 통합 경계

| 항목 | 공식 사양 |
| - | - |
| 모델 ID | `gpt-6.1-terra` |
| 컨텍스트 윈도우 | 1,050,000 tokens |
| 최대 출력 | 128,000 tokens |
| 지식 기준일 | 2026년 6월 1일 |
| 입력 / 출력 | 텍스트 및 이미지 / 텍스트 |
| 추론 수준 | `none`, `low`, `medium` (기본값), `high`, `xhigh`, `max` |
| 기능 | 스트리밍, 함수 호출, 구조화된 출력 |

> [!NOTE]
>
> 이 표에는 OpenAI의 공식 사양이 나와 있습니다. APIYI의 공개 카탈로그에는 `CodexResponses`, `default`, `svip` 그룹이 나와 있으며, 액세스 가능 여부는 API 키의 그룹에 따라 달라집니다. 아래 테스트는 현재 테스트 키의 인터페이스 동작을 확인하며, 모든 그룹과 도구 또는 전체 컨텍스트 한도를 검증하는 것은 아닙니다.

## API 기능 테스트

2026년 10월 27일 (UTC+8), 확인을 더 빠르게 마치기 위해 테스트 키 하나와 최대 20개의 동시 실행 작업을 사용해 **생성 요청 50건**을 완료했습니다. 모든 요청의 콘텐츠와 완료 상태를 확인했으며, 자동 재시도는 수행하지 않았습니다. 이는 기능 테스트이며 용량 테스트가 아닙니다.

| 확인 항목 | 요청 수 | 관찰 결과 |
| - | - | - |
| 사전 확인, 영어, 중국어 및 산술 | 8 | 두 API 모두 예상한 결과를 반환했습니다 |
| 스트리밍 | 4 | 텍스트 델타와 정상 완료 신호가 올바르게 반환되었습니다 |
| JSON Schema | 4 | 필드, 유형 및 지정된 값이 일치했습니다 |
| 여섯 가지 추론 수준 및 기본값 | 14 | 매개변수가 수락되었으며 간단한 질문에 올바르게 답변했습니다 |
| 이미지 이해 | 4 | 두 API 모두 합성 이미지에서 지정된 색상을 식별했습니다 |
| Responses 도구 왕복 | 2 | 인수가 올바르고 로컬 도구 결과가 수락되었으며 최종 답변은 42였습니다 |
| 다중 턴 대화 | 4 | 채팅 기록과 Responses `previous_response_id`에 테스트 정보가 유지되었습니다 |
| 반복 캐시 요청 | 6 | 텍스트는 올바르게 반환되었으며 아래의 캐시 관찰 결과는 서로 다릅니다 |
| 더 긴 입력 확인 | 4 | 실제 입력 길이가 8,230 및 32,806 tokens일 때 두 API 모두 숨겨진 마커를 검색했습니다 |

**캐시 동작은 API별로 별도 보고해야 합니다.** 각 엔드포인트에서 동일한 접두부를 세 번 연속 요청에 재사용했습니다. Responses는 두 번째와 세 번째 요청에서 캐시된 token 2,653개를 보고했으며, Chat은 세 요청 모두에서 캐시 적중을 보고하지 않았습니다. 따라서 이번 실행에서 확인된 캐시 적중은 Responses 샘플에 한정되며, Chat의 캐시 절감 효과는 입증되지 않았습니다.

추론 확인은 매개변수가 수락되는지와 간단한 작업의 결과를 검증한 것이며, 추론 수준별 품질 순위를 평가한 것이 아닙니다. 추론 수준이 높을수록 항상 더 낫다는 점을 입증하지도 않습니다. 이번 실행에서는 백만 token 컨텍스트 제한, 캐시 유지 시간, 입력 token 272K를 초과하는 실제 과금 또는 장기적인 신뢰성을 확인하지 않았습니다.

## 마이그레이션 시 매개변수 차이

GPT-6.1 Terra는 `none`을 지원합니다. GPT-6.1 Sol에서 추론 비활성화를 제한하는 규칙을 Terra에 적용하지 마세요. 기존 애플리케이션을 마이그레이션할 때는 먼저 추론 수준, 입력 샘플, 출력 요구 사항을 동일하게 유지한 다음 결과를 비교하세요.

추론 강도가 `none`이 아닌 경우 공식 마이그레이션 가이드를 따르고 `temperature`, `top_p`, `top_logprobs`를 제거하세요. 또한 채팅 완성 요청에는 `logprobs`를 포함하지 마세요. 도구를 사용하려면 응답 API를 선택하고, 모델이 반환한 인수로 도구를 실행한 다음 결과를 다시 전송하세요.

## API 예시

`pip install -U openai`을 사용해 OpenAI Python SDK를 설치합니다. 먼저 로컬 환경에서 `APIYI_API_KEY`을 설정합니다. 실제 키를 스크립트, 프런트엔드 코드, 커밋 기록에 포함하지 않습니다.

두 API의 기본 매개변수 형식은 이 테스트 실행에서 검증되었습니다. 이 예시에서는 환경 변수에서 키를 읽습니다. 이미지, 도구 또는 긴 문서를 추가하기 전에 짧은 텍스트 요청부터 시작합니다.

```python 응답 API theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)

response = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="Make this sentence clearer without changing its meaning: Integration testing will begin after the API is confirmed.",
    max_output_tokens=1024,
)
print(response.output_text)
```

```python 채팅 완성 theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-6.1-terra",
    reasoning_effort="none",
    messages=[{"role": "user", "content": "Explain in one sentence how to check whether an API response succeeded."}],
    max_completion_tokens=1024,
)
print(response.choices[0].message.content)
```

전체 매개변수 및 도구 결과 처리에 관한 내용은 [응답 API](https://docs.apiyi.com/ko/api-capabilities/openai/native.md), [호환 API](https://docs.apiyi.com/ko/api-capabilities/openai/compatible.md), [응답 처리](https://docs.apiyi.com/ko/api-capabilities/openai/response-handling.md)를 참조하세요.

## 가격 및 이용 가능 여부

### 표준 가격

다음 가격은 2026년 10월 27일에 확인했습니다. 요율은 충전 보너스 또는 계정 그룹 할인을 적용하기 전의 백만 token당 USD입니다. 입력 token이 272K 이하인 요청에 적용되는 OpenAI의 표준 티어 가격입니다.

| 과금 항목 | APIYI 공개 가격 | OpenAI 표준 가격 |
| - | - | - |
| 입력 | \$1.00 | \$1.00 |
| 출력 | \$5.00 | \$5.00 |
| 캐시 읽기 | \$0.05 | \$0.05 |

> [!NOTE]
>
> 모델 가격은 공급업체의 공식 가격과 일치하며, 해당 가격이 변경되면 함께 변경될 수 있습니다. 이 표는 참고용이며, 상단 탐색 메뉴의 **모델 가격** 탭이 기준입니다: [모델 가격](https://docs.apiyi.com/ko/models/index.md).

예를 들어 캐시되지 않은 입력 token 10,000개와 출력 token 2,000개의 비용은 캐시 쓰기, 추가 도구 요금, 그룹 할인을 제외하고 표준 요율 기준 \$0.02입니다. 이는 과금 예시이며 작업당 고정 가격이 아닙니다.

### 캐싱 및 긴 컨텍스트

APIYI의 공개 설정에는 캐시 쓰기 요금이 백만 token당 \$1.25로 표시되어 있습니다. OpenAI는 30분 및 12시간의 보존 기간에 대해 각각 \$1.25와 \$2.50의 별도 요금을 표시합니다. 플랫폼의 공개 필드에는 보존 기간이 명시되어 있지 않으므로 두 모드를 모두 사용할 수 있다고 단정할 수 없습니다.

> [!WARNING]
>
> OpenAI는 입력 token이 272K를 초과하는 요청의 경우 전체 요청에 기본 입력 및 캐시 요율의 2배, 기본 출력 요율의 1.5배를 적용한다고 명시합니다. 이번 검토에서 APIYI의 공개 설정에는 Terra 전용 티어 조건이 표시되지 않았습니다. 따라서 공식 티어 요율을 플랫폼의 확인된 과금액으로 간주해서는 안 되며, 전체 컨텍스트 윈도우에 걸쳐 기본 가격이 적용된다고 가정해서도 안 됩니다. 콘솔에서 과금을 확인하고 대규모 요청을 제출하기 전에 소액 테스트를 실행하십시오.

공개 카탈로그에는 `CodexResponses`, `default` 및 `svip`이 표시되어 있습니다. 모델 가격, 그룹 액세스 및 추가 기능은 현재 콘솔에서 확인하십시오. 충전 혜택은 [충전 프로모션](https://docs.apiyi.com/ko/faq/recharge-promotions.md)에서 확인할 수 있습니다.

## 통합 권장 사항

소규모의 고정된 샘플 세트를 사용해 세 가지를 확인합니다. 답변이 요구 사항을 충족하는지, API 매개변수가 호환되는지, 실제 요금이 예산에 맞는지 확인합니다. 시각 테스트에는 흐릿한 이미지와 작은 글자가 포함된 스크린샷을 포함하고, 작성 테스트에서는 사실과 의미 보존 여부를 확인하며, 도구 테스트에서는 인수와 결과 전달을 검증합니다. 각 요청의 모델 ID, 추론 수준, token 사용량을 기록해 차이를 재현할 수 있도록 합니다.

## 출처

2026년 10월 27일(UTC+8)에 확인한 출처입니다. 복사할 수 있도록 외부 출처는 일반 텍스트로 표시합니다.

* OpenAI API 변경 기록: `developers.openai.com/api/docs/changelog`
* OpenAI 모델 사양: `developers.openai.com/api/docs/models/gpt-6.1-terra`
* OpenAI 표준 요금: `developers.openai.com/api/docs/pricing`
* OpenAI 매개변수 및 마이그레이션 가이드: `developers.openai.com/api/docs/guides/latest-model`
* APIYI 실시간 요금: [공개 요금 API](https://api.apiyi.com/api/pricing), [공개 요율 구성](https://api.apiyi.com/api/ratio_config), [모델 요금](https://docs.apiyi.com/ko/models/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.