GPT-6 Astra API: 첫 요청과 GPT-5.6 Sol에서의 마이그레이션

BetterToken에서 첫 smoke test를 하려면 Model ID를 gpt-6-astra로 바꾸고 OpenAI-compatible Chat Completions endpoint에 짧은 요청을 보냅니다. 하지만 운영 중인 app의 마이그레이션에는 추가 변경이 필요합니다. GPT-6 Astra는 reasoning effort none을 지원하지 않고, 여러 sampling 및 logprobs parameters를 제거해야 하며, tool calling에는 Responses API가 필요합니다.

아래 절차는 text request로 시작해 gpt-5.6-sol에서 최소한의 통제된 diff를 적용합니다. 문서로 확인된 경로이며, 글을 준비하며 실제 API Key로 유료 call을 실행하지 않았습니다.

준비와 첫 요청

2026년 9월 6일 기준 BetterToken 공개 catalog에는 gpt-5.6-sol과 gpt-6-astra가 GPT group에 있습니다. 자신의 account, 현재 group용 Key, Base URL https://www.bettertoken.ai/v1, Bearer token과 JSON을 보낼 HTTP client가 필요합니다.

BetterToken 계정과 GPT-6 Astra API Key 만들기

Catalog와 Setup에서 최신 Model ID를 확인하고 Key를 code, issue, screenshot, support message에 넣지 마세요. local environment에만 export합니다.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

BetterToken 공개 API Reference의 endpoint를 사용합니다.

curl "https://www.bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "gpt-6-astra",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: ASTRA_OK"
      }
    ]
  }'

성공 응답의 text는 choices[0].message.content에 있고 이 fixture는 ASTRA_OK를 기대합니다. 401, 403, model not found가 없고 content가 비어 있지 않으며 Dashboard에 gpt-6-astra, status, input/output/cache tokens가 기록되는지 확인합니다. 이는 Key, endpoint, Model ID, 기본 response shape을 확인할 뿐 tools, SDK streaming, production 품질, Sol과의 동등성을 증명하지 않습니다.

GPT-5.6 Sol에서의 최소 diff

 {
-  "model": "gpt-5.6-sol",
+  "model": "gpt-6-astra",
   "messages": [
     {"role": "user", "content": "Summarize this incident report."}
   ]
 }

이전 요청이 reasoning effort none 또는 minimal을 썼다면 Astra를 low에서 시작합니다. Chat Completions field는 reasoning_effort입니다.

{
  "model": "gpt-6-astra",
  "reasoning_effort": "low",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this incident report. Preserve dates and owners."
    }
  ]
}

Sol이 다른 유효 level을 사용했다면 OpenAI는 첫 비교에서 이를 유지하도록 권합니다. Effort를 일괄 높이면 latency와 usage도 달라집니다.

지원하지 않는 parameters를 제거합니다.

 {
   "model": "gpt-6-astra",
   "reasoning_effort": "low",
-  "temperature": 0.2,
-  "top_p": 0.95,
-  "top_logprobs": 5,
-  "logprobs": true,
   "messages": [
     {"role": "user", "content": "Summarize this incident report."}
   ]
 }

OpenAI는 temperature, top_p, top_logprobs를 지원하지 않는다고 명시하며 Chat Completions에서는 logprobs도 제거해야 합니다. SDK가 defaults를 추가하면 설정 object가 아니라 serialized JSON을 확인합니다.

Text는 Chat Completions, tools는 Responses

GPT-6 Astra는 두 endpoint를 지원하지만 tool calling에는 OpenAI가 Responses를 요구합니다. BetterToken 일반 공개 reference는 Chat Completions를 문서화하고 Responses는 Codex setup에서 별도로 안내합니다.

목표	경로
Key, Model ID, text 확인	POST https://www.bettertoken.ai/v1/chat/completions
Codex에서 tools 사용	Codex 안내서의 custom provider와 wire_api = "responses"
자체 app에서 raw Responses	해당 channel의 현재 contract를 먼저 확인. 일반 reference에는 아직 없음

URL만 바꿔 tool schema를 옮기지 마세요. input items, tool-call 형식, state continuation, text extraction이 다릅니다. Transport 호환성이 같은 behavior를 뜻하지도 않습니다.

통제된 마이그레이션과 rollback

실제 app에서 정확한 짧은 응답, JSON Schema로 검증하는 structured output, 긴 production prompt, tool workflow, 의도적으로 잘못된 요청을 fixtures로 만듭니다. Sol의 Model ID, endpoint, 유효 reasoning, serialized body, acceptance check를 저장하고 최소 diff로 Astra에 같은 set을 실행합니다.

모든 fixtures가 통과하고 monitoring이 gpt-5.6-sol과 gpt-6-astra를 구분하며 rollback이 새 release 없이 이전 model과 parameters를 복원할 때만 traffic을 옮깁니다. 내부 workflow나 risk에 맞는 작은 비율부터 시작하세요. 보편적인 비율은 없습니다. 관찰 중에는 Sol 설정을 유지합니다.

빠른 문제 진단

• 401 Unauthorized: Authorization: Bearer ..., process environment, 복사된 공백을 확인하고 전체 Key를 log에 남기지 않습니다.
• 403 또는 model not found: group을 확인하고 정확한 gpt-6-astra를 복사합니다.
• 400: temperature, top_p, top_logprobs, logprobs를 제거하고 none 또는 minimal을 low로 바꿉니다.
• Text는 되지만 tools가 실패: endpoint를 확인합니다. smoke test는 Responses를 증명하지 않습니다. Codex에서는 wire_api = "responses"를 유지합니다.
• 성공했지만 UI가 비어 있음: secret 없는 raw response에서 choices[0].message.content, status, finish reason, adapter를 확인합니다.

Astra가 fixtures를 통과하고 별도로 관찰되며 설정으로 rollback될 때 마이그레이션이 완료됩니다. 첫 200은 연결 확인일 뿐 전체 마이그레이션 완료가 아닙니다.