빠른 답변: GPT-6.2 Astra API를 사용하려면 OpenAI의 Responses 엔드포인트(POST /v1/responses)로 "model": "gpt-6.2-astra", "high" 같은 추론 강도(reasoning effort), 그리고 입력값을 담아 요청을 보내면 됩니다. 비용은 입력 토큰 100만 개당 $8, 출력 토큰 100만 개당 $40이며, 최대 922K 입력 토큰을 받아 최대 128K를 반환합니다. 추론 강도를 none으로 설정하지 마세요. API가 이를 거부합니다.
OpenAI는 2026년 11월 17일 GPT-6.2 Astra와 더 저렴한 형제 모델인 GPT-6.2 Sol을 출시했습니다. 이전에 GPT-6 Astra를 호출해 본 적이 있다면 대부분의 코드를 그대로 재사용할 수 있습니다. 이 가이드에서는 첫 요청부터 도구 호출, 추론 강도 조정, 가격 관련 함정, 그리고 코딩 에이전트가 대신 실행할 수 있는 반복 가능한 테스트까지 GPT-6.2 Astra API를 단계별로 살펴봅니다.
첫 GPT-6.2 Astra API 호출 전에 준비해야 할 것들
네 가지가 필요하며, 아마 세 가지는 이미 갖고 있을 것입니다:
- 플랫폼 대시보드에서 발급받은 OpenAI API 키,
OPENAI_API_KEY로 내보내기(export) 해두세요. - 유료 사용 등급. OpenAI의 모델 페이지에 따르면 Astra의 속도 제한은 Build 등급(분당 5,000건 요청 및 100만 토큰)부터 시작합니다.
- 모델 ID
gpt-6.2-astra. 더 저렴한 모델은gpt-6.2-sol입니다. - 지원되는 엔드포인트: Responses, Chat Completions 또는 Batch. Realtime, Assistants, 파인튜닝은 두 모델 모두 지원하지 않습니다.
이 사양들은 2026년 11월 18일 기준으로 확인한 OpenAI의 GPT-6.2 Astra 모델 페이지에서 가져온 것입니다.
| 사양 | GPT-6.2 Astra |
|---|---|
| 모델 ID | gpt-6.2-astra |
| 컨텍스트 윈도우 | 1,050,000 토큰 |
| 최대 입력 | 922,000 토큰 |
| 최대 출력 | 128,000 토큰 |
| 지식 기준 시점 | 2026년 5월 18일 |
| 엔드포인트 | Responses, Chat Completions, Batch |
| 기능 | 스트리밍, 함수 호출, 구조화된 출력, 이미지 입력, 프롬프트 캐싱 |
첫 GPT-6.2 Astra API 요청 보내는 방법
OpenAI가 새 기능을 먼저 추가하는 곳은 Responses API이므로 여기서 시작하는 것이 좋습니다. 단계는 다음과 같습니다:
- 키 내보내기:
export OPENAI_API_KEY=sk-... - 모델 ID와 추론 강도를 담아 요청을 보냅니다.
- 응답은
output_text에서 답변을,usage에서 토큰 수를 확인합니다.
curl 사용 시:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-astra",
"reasoning": { "effort": "high" },
"input": "Review this migration plan and list the three biggest risks."
}'
공식 Python SDK 사용 시 (pip install --upgrade openai):
from openai import OpenAI
client = OpenAI() # reads OPENAI_API_KEY
response = client.responses.create(
model="gpt-6.2-astra",
reasoning={"effort": "high"},
input="Review this migration plan and list the three biggest risks.",
)
print(response.output_text)
print(response.usage)
Node.js 사용 시 (npm install openai):
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-6.2-astra",
reasoning: { effort: "high" },
input: "Review this migration plan and list the three biggest risks.",
});
console.log(response.output_text);
초기 호출마다 usage 블록을 확인하세요. Astra는 한 글자를 쓰기 전에 먼저 추론 토큰을 소모하며, 이 토큰은 출력으로 청구됩니다. 짧은 답변이라도 예상보다 비용이 많이 나올 수 있습니다.

GPT-6.2 Astra의 추론 강도 선택하기
추론 강도는 품질과 비용 모두에 가장 큰 영향을 주는 요소입니다. OpenAI의 추론 가이드에는 none, minimal, low, medium, high, xhigh, max 값이 나열되어 있으며, 각 모델은 이 중 일부만 지원한다고 설명합니다. GPT-6.2 Astra와 Sol의 경우 확인된 유일한 규칙은 none이 거부된다는 것이므로, 모든 호출에서 어느 정도의 추론이 이루어집니다.
| 강도 | 사용 사례 |
|---|---|
low / medium |
간단한 편집, 추출 작업, 짧은 답변 |
high |
코드 리뷰, 계획 수립, 대부분의 어려운 프롬프트. 테스트를 시작하기에 합리적인 기본값 |
xhigh |
긴 에이전트 실행 및 비동기 작업, 평가 결과에서 확실한 이득이 확인될 때만 |
max |
가장 어려운 문제, 더 나은 답변이 토큰 비용의 몇 배를 정당화할 때 |
OpenAI는 Astra의 기본 추론 강도를 명시하지 않으므로, 모든 요청에서 명시적으로 설정하세요. 그래야 비용과 테스트 결과를 재현 가능하게 유지할 수 있습니다.
추론 강도는 비용을 얼마나 바꿀까요? Simon Willison은 출시일에 동일한 이미지 프롬프트를 세 가지 강도 수준으로 각 모델에 실행하고 비용을 공개했습니다. Astra는 high에서 11.55센트, xhigh에서 17.70센트, max에서 88.71센트였습니다. high에서 max로 올리자 비용이 거의 8배가 되었습니다.

주목할 점은 GPT-6.2 Astra가 high와 xhigh에서는 GPT-6 Astra보다 저렴했지만 max에서는 더 비쌌다는 것입니다. 토큰당 가격은 20% 내렸지만 max 강도는 더 오래 추론하기 때문입니다. 백만 토큰당 비용이 아니라 완료된 작업당 비용을 측정하세요.
GPT-6.2 Astra API에서 도구와 구조화된 출력 사용하기
Astra는 Responses API에서 함수 호출, 구조화된 출력, 그리고 웹 검색, 파일 검색, 이미지 생성, 코드 인터프리터, 호스티드 셸, 패치 적용, 스킬, 컴퓨터 사용, MCP, 도구 검색 등 다양한 호스티드 도구를 지원합니다.
함수 도구는 GPT-6 Astra 때와 동일한 형태입니다:
response = client.responses.create(
model="gpt-6.2-astra",
reasoning={"effort": "high"},
tools=[{
"type": "function",
"name": "get_order_status",
"description": "Look up an order by its ID.",
"parameters": {
"type": "object",
"properties": {"order_id": {"type": "string"}},
"required": ["order_id"],
},
}],
input="Where is order A-1042?",
)
for item in response.output:
if item.type == "function_call":
print(item.name, item.arguments)
함수를 직접 실행한 뒤, 결과를 일치하는 call_id와 함께 function_call_output 항목으로 다시 보내세요. Astra가 이를 바탕으로 최종 답변을 작성합니다.
기계가 읽을 수 있는 출력이 필요하면 text.format에 "type": "json_schema"와 "strict": true로 JSON 스키마를 전달하세요. 그러면 모델이 스키마에 맞는 JSON을 반환하므로 추측 없이 파싱할 수 있습니다.
이 정도로 강력한 모델에는 두 가지 습관이 도움이 됩니다. 첫째, 각 도구에 간결한 설명과 엄격한 스키마를 제공하세요. 출시일 리뷰어들은 Astra가 길고 개방적인 작업에서 산으로 가는(벗어나는) 경향이 있다고 보고했습니다. 둘째, 에이전트 루프에는 max_output_tokens를 설정해 한 번의 무제어 실행이 예산을 낭비하지 않도록 하세요. 엔드포인트 자체에 대한 배경 지식은 OpenAI Responses API 가이드를 참고하세요.
GPT-6.2 Astra API 가격 및 속도 제한
Astra는 백만 토큰당 과금되며, 매우 긴 프롬프트에는 추가 요금이 붙습니다. 다음 요금은 모델 페이지에서 가져온 것입니다:
| 항목 | GPT-6.2 Astra | GPT-6 Astra (참고용) |
|---|---|---|
| 입력 | $8.00 | $10.00 |
| 캐시된 입력 | $0.40 | $1.00 |
| 캐시 쓰기 (30분 보관) | $10.00 | 해당 없음 |
| 출력 | $40.00 | $50.00 |
함정은 긴 컨텍스트 규칙입니다. 요청이 272K 입력 토큰을 초과하면 해당 요청 전체에 대해 입력 및 캐시 요금이 2배가 되고 출력은 1.5배가 됩니다. 300K 토큰 프롬프트는 기준선을 넘은 토큰만이 아니라 입력 $16, 출력 $60으로 청구됩니다. Astra에 저장소 전체를 입력하는 경우에는 가능한 한 272K 이하로 청크하거나 캐시하세요.
배치 작업은 기다릴 수 있는 평가와 백필에 적합합니다. VentureBeat에 따르면 배치는 절반 가격으로 실행됩니다.
등급별 표준 속도 제한:
| 등급 | 요청/분 | 토큰/분 |
|---|---|---|
| Build | 5,000 | 1,000,000 |
| Launch | 10,000 | 4,000,000 |
| Grow | 15,000 | 40,000,000 |
429 응답은 지수 백오프로 처리하세요. xhigh에서의 긴 에이전트 실행은 Build 등급 토큰 예산을 빠르게 소진할 수 있습니다.
GPT-6 Astra에서 GPT-6.2 Astra로 마이그레이션
대부분의 코드에서는 모델 문자열 하나만 바꾸면 됩니다. 프로덕션에 적용하기 전에 다음 사항을 확인하세요:
- 모델 ID:
gpt-6-astra를gpt-6.2-astra로 변경. - 강도
none: 이 값을 보내는 코드 경로가 있다면 이제 실패합니다. 평가에서 허용하는 가장 낮은 값으로 전환하세요. - 프롬프트 캐싱: 캐시된 입력이 $1.00에서 $0.40으로 내려갔으므로, 이제는 안정적인 시스템 프롬프트와 도구 목록을 캐시할 가치가 있습니다.
- 긴 프롬프트: 272K 토큰에 근접한 요청은 위의 긴 컨텍스트 규칙에 맞춰 다시 확인하세요.
- 안전성: OpenAI에 따르면 두 GPT-6.2 모델 모두 'Critical' 사이버보안 기준에 도달하며 더 엄격한 안전장치와 함께 출시됩니다. 보안 도구 관련 프롬프트는 이전에는 받지 않았던 거절 응답을 받을 수 있습니다.
초기 평가는 호불호가 갈리므로 전환 전에 테스트하세요. Ethan Mollick은 Astra를 "매우 들쭉날쭉하고 이상하다"고 평했고, VentureBeat의 종합 기사에 따르면 Dan Shipper는 엔드투엔드 빌드에서 조기에 멈추는 경우가 잦다고 지적했습니다. 반면 코드 리뷰와 컴퓨터 사용 기능을 칭찬한 이들도 있었습니다. 중요한 벤치마크는 결국 여러분 자신의 프롬프트입니다. GPT-6 Astra API 가이드는 이전 세대에서 이어지는 내용을 다루고, 대부분의 트래픽이 루틴한 작업이라면 GPT-6.1 Sol API 가이드에서 더 저렴한 등급의 요청 형태를 확인할 수 있습니다.
Apidog CLI로 코딩 에이전트가 GPT-6.2 Astra를 테스트하게 하기
터미널에 프롬프트를 붙여넣는 것으로는 오늘 Astra가 어떻게 수행했는지만 알 수 있습니다. 다음 달 업데이트가 여러분의 스키마를 깨뜨릴 때는 알려주지 못하죠. 코딩 에이전트가 검증을 구축하고 Apidog CLI로 실행하도록 하세요. 여러분은 프롬프트 하나만 작성하면 됩니다.
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
그런 다음 Claude Code, Codex 또는 Cursor에 다음 프롬프트 하나를 주세요:
In Apidog project <projectId>, create a test case for POST https://api.openai.com/v1/responses
with model "gpt-6.2-astra", reasoning effort "high" and a get_order_status function tool.
Assert status 200, that the output contains a function_call named get_order_status,
that its arguments parse as JSON with an order_id, and that usage.output_tokens is under 4000.
Read the API key from the OPENAI_API_KEY variable in environment <envId>, then run it.
에이전트는 페이로드 스키마를 읽고, 자체 파일을 확인하고, 케이스를 생성한 뒤 실행합니다:
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
API 키는 프롬프트에 넣지 말고 Apidog 환경에 보관하세요. 그래야 에이전트의 컨텍스트에 키가 노출되지 않습니다. --upload-report를 추가하면 Apidog 앱에서 실행 결과를 검토할 수 있고, -n 5를 추가해 반복 실행하면 Astra의 도구 호출이 얼마나 안정적인지 확인할 수 있습니다. 파이프라인에 -r junit을 넣으면 배포할 때마다 검증이 다시 실행됩니다. 설정 방법은 CI/CD에서의 Apidog CLI 가이드를, 에이전트 측 설정은 Claude Code에서의 Apidog CLI 문서를 참고하세요. Apidog의 무료 플랜은 최대 4명의 팀까지 지원합니다.
FAQ
GPT-6.2 Astra API의 모델 ID는 무엇인가요? gpt-6.2-astra입니다. 더 저렴한 형제 모델은 gpt-6.2-sol입니다. 두 모델 모두 Responses, Chat Completions, Batch 엔드포인트에서 작동합니다.
GPT-6.2 Astra API 비용은 얼마인가요? 입력 토큰 100만 개당 $8, 캐시된 입력 토큰 100만 개당 $0.40, 출력 토큰 100만 개당 $40입니다. 272K 입력 토큰을 초과하는 요청은 요청 전체에 대해 입력 2배, 출력 1.5배의 요금이 부과됩니다.
GPT-6.2 Astra 요청이 추론 강도 none에서 실패하는 이유는 무엇인가요? 두 GPT-6.2 모델 모두 "effort": "none"을 거부합니다. high로 설정하거나, 여러분의 테스트에서 해당 작업에 적합하다고 확인된 가장 낮은 수준을 사용하세요.
GPT-6.2 Astra의 컨텍스트 윈도우는 얼마인가요? 총 1,050,000 토큰으로, 최대 922,000 입력 토큰과 128,000 출력 토큰입니다.
GPT-6.2 Astra를 Chat Completions API에서 사용할 수 있나요? 네, 지원됩니다. 다만 웹 검색, 컴퓨터 사용, 패치 적용 같은 호스티드 도구는 Responses API 기준으로 안내되어 있으므로, 에이전트 작업에는 Responses를 사용하세요.
GPT-6.2 Astra를 무료로 사용할 수 있나요? API에서는 불가능하며 모든 호출에 요금이 청구됩니다. ChatGPT Work와 Codex에서는 Plus, Pro, Enterprise, Edu 플랜에 포함되어 있습니다. 자세한 내용은 OpenAI의 출시 공지를 참고하세요.
