작성자 주: 콘솔에서 진행하는 순서에 따라 5단계로 GPT-6.1 Terra API를 연동하고, 엔드포인트 선택과 매개변수 주의사항, 272K 단계별 요금제를 설명해요.
먼저 결론부터 말씀드리면, GPT-6.1 Terra를 연동할 때 핵심은 Responses와 Chat Completions 중 무엇을 사용할지 선택하는 거예요. 도구 호출이 필요하다면 Responses를 사용해야 해요. 도구가 필요하지 않다면 기존 코드에서 모델명만 바꿔도 대부분 그대로 실행할 수 있어요.
GPT-6.1 Terra는 2026-10-26에 출시됐고, 모델 ID는 gpt-6.1-terra예요. 공식 문서에 엔드포인트와 매개변수, 요금 규칙이 명시돼 있어 확인할 수 있어요. 이 글에서는 콘솔 페이지에서 진행하는 순서에 따라 가입 → 토큰 생성 → Base URL 확인 → 모델명 입력 → 첫 요청 실행을 안내해요. 각 단계의 확인 기준도 함께 제공하고, 명령줄과 코드는 선택 사항으로 소개해요.
핵심 가치: 이 글을 읽고 나면 콘솔에서 GPT-6.1 Terra API 연동 과정을 검증하고, 가장 흔한 400 오류를 피할 수 있어요.
📌 플랫폼 현황 안내: 2026-10-27 기준, APIYI apiyi.com의 실시간 모델 목록에는 아직
gpt-6.1-terra가 없어요. 해당 모델은 최대한 빨리 출시할 예정이에요. 같은 세대의gpt-6-astra,gpt-6-sol,gpt-6.1-sol,gpt-6-luna는 이미 제공 중이므로, 우선gpt-6.1-sol로 연동 과정을 검증할 수 있어요. 모델과 가격은 플랫폼의 모델 목록을 기준으로 확인해 주세요.
GPT-6.1 Terra API 핵심 요점
| 핵심 요점 | 설명 | 어떤 의미인가요? |
|---|---|---|
| 모델 ID | gpt-6.1-terra, 2026-10-26 출시 |
요청의 model 필드에 이 값을 입력하세요 |
| 사용 가능한 엔드포인트 | Responses, Chat Completions, Batch | Realtime, Assistants, Embeddings 등의 엔드포인트는 지원하지 않아요 |
| 도구 호출 | Responses만 지원 | Chat에 tools를 포함하면 요청이 실패해요 |
| 컨텍스트 | 총 1,050,000, 입력 1회당 922,000, 출력 128,000 | 긴 문서에 적합하지만 272K 요금 구간에 유의하세요 |
| 모달리티 | 텍스트와 이미지 입력, 텍스트 출력 | 이미지 입력에는 Responses의 input_image를 사용하세요 |
| 지식 기준일 | 2026-06-01 | 최신 정보는 web_search 도구를 함께 사용해 가져와야 해요 |
GPT-6.1 Terra의 기능 범위 자세히 알아보기
GPT-6.1 Terra는 스트리밍, 구조화된 출력, 함수 호출, file_search, 이미지 입력, 웹 검색, 프롬프트 캐싱을 지원하지만, 파인튜닝과 예측 출력은 지원하지 않아요. 기존 프로젝트에서 미세 조정한 모델이나 예측 출력에 의존한다면 그대로 마이그레이션할 수 없어요.
Responses 엔드포인트에는 web_search, file_search, image_generation, code_interpreter, hosted_shell, apply_patch, skills, computer_use, mcp, tool_search 등 다양한 도구를 연결할 수 있어요. 이 때문에 도구를 사용하려면 Responses를 선택해야 해요. 이 모델에서 Chat Completions는 일반 대화만 처리해요.
GPT-6.1 Terra API 호출 방법: 콘솔에서 진행하는 5단계
1단계: 계정 등록
- APIYI apiyi.com을 열고 페이지 안내에 따라 본인 정보로 계정을 등록하세요. 플랫폼에서는 본인이 직접 등록해야 해요.
- 신규 계정에는 0.05달러의 체험 크레딧이 기본 제공돼요. 충전하지 않아도 간단한 호출을 한 번 테스트할 수 있어요.
- 확인 기준: 로그인한 뒤 콘솔에 들어가 지갑 또는 잔액 페이지에서 체험 크레딧이 표시되는지 확인하세요.
- 막히면 확인할 사항: 크레딧이 보이지 않으면 먼저 등록 절차를 모두 완료했는지 확인하세요. 바로 충전할 필요는 없어요.
공식 경로를 이용하려면 OpenAI 플랫폼의 API Keys 페이지에서 키를 생성해야 해요. 계정이 지원 지역에 있어야 하며, Build 티어에 해당하는 최소 5달러를 충전해야 합니다.
2단계: 토큰을 만들고 올바른 그룹 선택하기
- 콘솔의 토큰 페이지
api.apiyi.com/token으로 이동해 토큰 만들기를 클릭하세요. - 그룹 선택에서 그룹을 고르세요. 그룹에 따라 사용할 수 있는 모델, 요금 배수, 업스트림 경로가 달라져요.
default와svip는 공식 요금과 동일하고,CodexReverse는 역방향 리소스를 사용해요. - 확인 기준: 저장한 뒤 토큰 목록에
sk-로 시작하는 키가 표시돼요. - 문제가 생기면 확인하세요: 사용자 계정의 그룹과 토큰 그룹은 달라요. 실제 적용되는 그룹은 토큰에서 선택한 그룹이에요.
3단계: Base URL 확인하기
Base URL은 SDK에 따라 달라요. 가장 자주 잘못 입력하는 부분이에요.
- OpenAI SDK:
https://api.apiyi.com/v1—/v1을 포함해야 해요. - Anthropic SDK: 루트 도메인을 사용하고
/v1은 포함하지 않아요. - Google GenAI SDK: 루트 도메인을 사용하고
api_version을v1beta로 설정하세요.
확인 기준: GPT-6.1 시리즈는 OpenAI SDK 또는 OpenAI 호환 클라이언트를 사용하고, 주소 끝에 /v1을 붙이세요. 문제가 생기면 확인하세요: 404 오류가 발생하면 대부분 /v1을 빠뜨렸거나 중복으로 입력한 경우예요.
4단계: 모델 이름 입력하기
클라이언트나 디버깅 도구의 모델 필드에 모델 ID를 입력하세요. 먼저 gpt-5.4-mini 같은 경량 모델로 연결을 확인한 다음 gpt-6.1-sol로 바꾸는 것을 권장해요. gpt-6.1-terra가 플랫폼에 등록되면 필드 하나만 수정하면 됩니다. 플랫폼에서는 auto, auto:free 같은 무료 라우팅 표기를 지원하지 않으니 사용하지 마세요.
확인 기준: 모델 이름이 플랫폼의 모델 목록 표기와 한 글자도 다르지 않아야 해요. 문제가 생기면: 모델이 없다는 오류가 표시될 경우 먼저 모델 목록에서 철자를 확인하고, 토큰 그룹에 해당 모델이 포함되어 있는지 살펴보세요.
5단계: 첫 요청 보내기
다음은 최소한으로 실행할 수 있는 예시예요. 원하는 방식을 선택하세요. 총 5줄입니다.
- 환경 변수 설정:
export OPENAI_API_KEY=sk-你的令牌 - 클라이언트 생성:
client = OpenAI(base_url="https://api.apiyi.com/v1")— Key는 환경 변수에서 자동으로 읽어 와요. - Responses 방식:
r = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "low"}, max_output_tokens=800) - Chat 방식:
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "简洁回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800) - 출력 확인:
print(c.model, c.usage.prompt_tokens)
확인 기준: 요청이 HTTP 200을 반환하고 usage.prompt_tokens에 숫자가 표시되어야 해요. Responses 방식에서는 usage.input_tokens를 확인하세요. gpt-6.1-terra로 바꾼 뒤 응답의 model 필드에 해당 모델 이름이 표시되는지도 확인하세요.
🚀 빠른 시작: 먼저 APIYI apiyi.com의 체험 한도로
gpt-6.1-sol을 실행해 Key, 그룹, Base URL이 모두 정상인지 확인해 보세요. Terra가 등록되면 모델 이름만 바꾸면 전환할 수 있어요. 모델명과 가격은 플랫폼의 모델 목록을 기준으로 확인하세요.
| 단계 | 콘솔 작업 | 확인 기준 | 문제가 생기면 먼저 확인할 항목 |
|---|---|---|---|
| 1 가입 | 본인 명의로 가입하고 로그인 | 0.05달러 체험 한도가 표시됨 | 가입 절차가 완료되었는지 |
| 2 토큰 | 토큰을 새로 만들고 그룹 선택 | 목록에 sk-로 시작하는 Key가 표시됨 |
토큰 그룹과 사용자 그룹을 혼동하지 않았는지 |
| 3 Base URL | OpenAI SDK에 /v1 주소 입력 |
주소가 /v1로 끝남 |
404가 발생하면 /v1 확인 |
| 4 모델 이름 | gpt-6.1-sol 등의 모델 입력 |
모델 목록 표기와 한 글자도 다르지 않음 | 철자와 그룹의 모델 포함 범위 |
| 5 요청 | 첫 번째 호출 전송 | 200 반환, usage에 숫자 표시 | 상태 코드, 응답 본문, x-request-id |
물론 Magpie를 이용해 더 간편하게 연동할 수도 있어요. 그래픽 인터페이스에서 Key와 Base URL을 입력하면 Claude Code, Codex, Pi, Hermes 같은 코딩 에이전트를 하나의 게이트웨이에 자동으로 연결해 줍니다. 설정 파일을 일일이 수정할 필요가 없어요.
GPT-6.1 Terra API 엔드포인트 선택: Responses와 Chat Completions 비교
| 비교 항목 | Responses（v1/responses） | Chat Completions（v1/chat/completions） |
|---|---|---|
| 도구 호출 | 지원하며, 10가지 내장 도구를 연결할 수 있음 | 지원하지 않음. tools를 포함하면 실패함 |
| 시스템 지침 | instructions |
messages의 developer 역할을 사용하며, system보다 안정적 |
| 추론 강도 | reasoning: {effort: ...} |
reasoning_effort |
| 출력 한도 | max_output_tokens |
max_completion_tokens |
| 입력 형식 | 문자열 또는 메시지 배열. 이미지는 input_image 사용 | messages 배열 |
| 여러 차례 대화 재생 | include: ["reasoning.encrypted_content"]를 지정하고 이전 턴의 output을 그대로 전달 |
대화 기록을 직접 이어 붙여야 함 |
| 스트리밍 usage | 기본 반환 | stream_options: {include_usage: true}를 추가해야 함 |
Chat Completions 비교 분석: Chat 엔드포인트는 기존 코드와의 호환성이 뛰어나 대부분의 프로젝트에서 모델 이름만 바꾸면 실행할 수 있어요. 하지만 Terra에서는 도구를 호출할 수 없고, 일부 그룹에서는 system 메시지가 제거되기도 해요. 반면 Responses는 도구를 기본 지원하고 암호화된 추론 내용을 다시 전달할 수 있어 Agent와 다중 턴 추론 시나리오에 더 적합해요.
추론 강도는 none, low, medium(기본값), high, xhigh, max의 6단계이며, minimal은 없어요. 추론 토큰은 출력 요금과 출력 한도에 포함되므로 max_output_tokens에 여유를 둬야 해요. 그렇지 않으면 추론이 끝나기도 전에 출력이 잘릴 수 있어요.
GPT-6.1 Terra API에서 자주 빠지는 파라미터 함정 3가지
| 함정 | 잘못된 방식 | 올바른 방식 | 결과 |
|---|---|---|---|
| Chat에 tools 전달 | chat.completions에 tools 전달 | Responses 엔드포인트 사용 | 요청 실패 |
| 구식 파라미터 사용 | Chat 엔드포인트에서 max_tokens 전달 |
max_completion_tokens로 변경 |
400 |
| 샘플링 파라미터 충돌 | effort가 none이 아닌 상태에서 temperature 또는 top_p 전달 | temperature, top_p, top_logprobs 삭제. Chat 엔드포인트에서는 logprobs도 삭제 | 400 |
이 세 가지 외에도 공식 문서에서 400 오류를 일으킬 수 있다고 안내하는 경우가 몇 가지 더 있어요. effort에 minimal을 전달하거나, prompt_cache_options.ttl에 유효하지 않은 값을 전달하거나, 입력 토큰이 922,000개를 초과하면 오류가 발생할 수 있습니다. 이미지 입력 링크는 서버에서 다운로드할 수 있어야 해요. 크롤링을 차단하는 사이트라면 요청이 실패할 수 있으니, 이럴 때는 base64 데이터 URL을 사용하는 편이 더 안정적입니다.
오류를 확인할 때 기억해야 할 점이 있어요. 오류 원문은 응답 본문에만 한 번 표시되고, 백엔드 로그는 과금 내역을 기록하는 장부라서 실패한 호출은 기록되지 않습니다. 따라서 HTTP 상태 코드, 원본 응답 본문 전체, 응답 헤더의 x-request-id를 보관해야 해요. 먼저 raise_for_status()를 호출한 뒤 본문을 읽으면 오류 정보가 사라질 수 있으니 주의하세요.
GPT-6.1 Terra API 가격 및 272K 요금 구간
아래는 공식 요금이며, 단위는 토큰 100만 개당 달러입니다. 요금 구간은 요청 전체를 기준으로 적용돼요. 입력이 272K를 초과하면 해당 요청의 모든 항목에 두 번째 구간의 요금이 적용됩니다.
| 과금 항목 | 입력 ≤ 272K | 입력 > 272K |
|---|---|---|
| 입력 | 1 | 2 |
| 출력(추론 토큰 포함) | 5 | 7.5 |
| 캐시 읽기 | 0.05 | 0.1 |
| 캐시 쓰기(30분) | 1.25 | 2.5 |
| 캐시 쓰기(12시간) | 2.50 | 5 |
비용을 추정할 때는 입력, 출력, 캐시 읽기, 캐시 쓰기 네 가지 항목을 모두 계산해야 해요. 캐시 쓰기는 30분과 12시간, 두 가지 유지 시간도 구분해야 합니다. 입력과 출력 단가만 살펴보면 긴 컨텍스트와 캐시를 사용하는 시나리오에서 실제 비용을 낮게 추정할 수 있어요. 플랫폼에 등록된 같은 세대의 모델은 네 가지 항목의 요금이 공식 요금과 각각 동일하며, 요청 전체에 두 구간 중 하나를 적용하는 방식도 같습니다.
공식 Standard 등급의 요청 제한은 다음과 같아요. Build는 5,000 RPM / 100만 TPM, Launch는 1만 RPM / 400만 TPM, Grow는 1.5만 RPM / 4,000만 TPM입니다.
💰 비용 절감 팁: 긴 문서 작업은 요청당 입력을 272K 이내로 유지하고 프롬프트 캐싱을 함께 사용하면 단가를 크게 낮출 수 있어요. APIYI apiyi.com에서
default또는svip그룹을 선택하면 공식과 동일한 요금이 적용됩니다. 구체적인 모델과 가격은 플랫폼의 모델 목록을 확인해 주세요.
GPT-6.1 Terra API 보안 안내
키는 환경 변수나 비밀 관리 서비스에 저장하고, 소스 코드에 하드코딩하거나 Git 저장소에 커밋하지 마세요. .gitignore에서 .env 파일을 제외하는 것이 좋습니다. 키가 유출되면 즉시 토큰 페이지에서 삭제하고 새로 발급하세요. 토큰을 발급할 때는 그룹도 올바르게 선택해야 합니다. 그룹이 잘못되면 모델을 사용할 수 없다는 오류가 발생할 수도 있고, 예상과 다른 요율로 요금이 청구될 수도 있습니다. 프로젝트마다 서로 다른 토큰을 사용하는 편이 사용 한도를 각각 관리하고 토큰을 비활성화하기에 좋습니다.
자주 묻는 질문(FAQ)
Q1: GPT-6.1 Terra란 무엇인가요?
OpenAI가 2026-10-26에 출시한 모델로, ID는 `gpt-6.1-terra`입니다. 컨텍스트 길이는 1,050,000이며, 입력으로 텍스트와 이미지를 지원하고 출력은 텍스트입니다. Responses, Chat Completions, Batch 세 가지 엔드포인트로 호출할 수 있습니다.
Q2: GPT-6.1 Terra에서 Responses와 Chat Completions 중 무엇을 선택해야 하나요?
도구 호출(function calling, web_search 등)이 필요하다면 Responses를 선택하세요. 단순한 대화에는 Chat도 사용할 수 있지만, `max_completion_tokens`를 사용해야 하며 `tools`를 포함할 수 없습니다.
Q3: APIYI에서 지금 `gpt-6.1-terra`를 호출할 수 있나요?
2026-10-27 기준으로는 아직 제공되지 않습니다. 이 모델을 최대한 빨리 출시할 예정입니다. 우선 APIYI apiyi.com에서 같은 세대의 `gpt-6.1-sol`로 연동 과정을 검증해 보세요. 모델명과 가격은 플랫폼의 모델 목록을 기준으로 확인해 주세요.
Q4: `temperature`를 전달했더니 왜 400 오류가 발생하나요?
추론 강도가 `none`이 아니면 `temperature`, `top_p`, `top_logprobs`를 전달할 수 없습니다. 해당 매개변수를 삭제하거나 `effort`를 `none`으로 설정하세요.
Q5: 충전하지 않고도 테스트할 수 있나요?
네. APIYI apiyi.com에 새로 가입하면 0.05달러의 체험 크레딧이 제공되어 가벼운 호출을 한 번 테스트하기에 충분합니다. 먼저 `gpt-5.4-mini`로 연동 과정을 확인한 다음, 사용하려는 모델로 전환하는 것을 권장합니다.
Q6: GPT-6.1 Terra의 알려진 제한 사항은 무엇인가요?
fine-tuning과 predicted outputs를 지원하지 않으며, Realtime, Assistants, Embeddings, Images, Audio 등의 엔드포인트도 지원하지 않습니다. 입력이 272K를 초과하면 전체 요청에 두 번째 요금 구간이 적용되고, 922,000토큰을 초과하면 400 오류가 발생합니다.
GPT-6.1 Terra API 핵심 요점
- 핵심 선택은 하나예요: 도구를 사용하려면 Responses를 쓰고, 그렇지 않다면 Chat에서 모델명만 바꾸면 돼요.
- 주의할 매개변수는 세 가지예요: Chat에서는
tools를 전달하지 않고,max_completion_tokens를 사용하며,effort가none이 아니면 샘플링 매개변수를 전달하지 마세요. - 콘솔 설정은 5단계예요: 가입, 토큰 생성 및 그룹 선택,
/v1을 포함한 Base URL 입력, 모델명 입력, 요청 실행. - 정상 작동 확인 신호: API 키가
sk-로 시작하고, 요청이 200을 반환하며,usage에 숫자가 표시되고,model필드에 모델명이 응답으로 돌아와야 해요. - 요금은 네 가지 항목으로 계산돼요: 입력, 출력, 캐시 읽기, 캐시 쓰기. 272K를 초과하면 요청 전체에 두 번째 요금 구간이 적용돼요.
- 시작하는 방법: 먼저 APIYI에서
gpt-6.1-sol로 전체 흐름을 확인하고, Terra가 등록되면 모델명만 바꾸세요.
요약
GPT-6.1 Terra API 연동의 핵심은 세 가지로 정리할 수 있어요.
- 엔드포인트를 먼저 선택하세요: Responses와 Chat 중 어떤 것을 쓸지 먼저 결정해야 해요. 이에 따라 매개변수 작성 방식과 도구 호출 가능 여부가 달라져요.
- 단계별로 확인하세요: 토큰, Base URL, 모델명, 첫 요청까지 각 단계마다 명확한 확인 신호가 있어요.
- 비용을 미리 파악하세요: 272K 기준 요금 구간은 요청 전체를 기준으로 적용되며, 캐시 관련 네 가지 비용도 예산에 반영해야 해요.
먼저 APIYI apiyi.com에서 gpt-6.1-sol로 전체 흐름을 확인해 보세요. 2026-10-27 기준으로 플랫폼에는 아직 gpt-6.1-terra가 등록되지 않았어요. 해당 모델은 최대한 빨리 제공할 예정이며, 모델명과 가격은 플랫폼의 모델 목록을 확인해 주세요.
📚 참고 자료
- OpenAI 모델 페이지 – GPT-6.1 Terra: 모델 사양 및 엔드포인트 지원
- 링크:
platform.openai.com/docs/models/gpt-6.1-terra -
설명: 컨텍스트, 모달리티, 사용 가능한 도구에 관한 공식 정보
-
OpenAI 최신 모델 가이드: 매개변수 변경 및 제한 사항
- 링크:
platform.openai.com/docs/guides/latest-model -
설명: reasoning.effort, max_completion_tokens 등의 매개변수 규칙
-
OpenAI 가격 페이지: 구간별 요금 및 캐시 가격
- 링크:
platform.openai.com/docs/pricing - 설명: 272K 구간별 요금과 캐시 쓰기 시간에 따른 가격
작성자: APIYI 기술팀
기술 문의: APIYI 웹사이트 홈페이지에서 문의해 주세요. 더 자세한 연동 방법은 docs.apiyi.com 문서 센터에서 확인할 수 있어요.
