GPT-6.1 Terra có sẵn trên OpenAI API dưới dạng gpt-6.1-terra, từ ngày 26 tháng 10 năm 2026. Nó hoạt động trên Responses API, Chat Completions và Batch, có giá $1 mỗi triệu token đầu vào và $5 mỗi triệu token đầu ra, và chấp nhận tối đa 922.000 token đầu vào và 128.000 token đầu ra. Nếu bạn đã gọi GPT-5.6 Terra, việc chuyển đổi hầu như chỉ là thay đổi model một dòng, với một vài cài đặt nên kiểm tra trước.
Hướng dẫn này bao gồm việc lấy khóa, yêu cầu đầu tiên của bạn bằng curl, Python và Node, sáu mức reasoning effort, computer use và các công cụ khác, kiểm soát chi phí, và những gì cần kiểm thử khi bạn di chuyển từ gpt-5.6-terra. Để xem tổng quan về mô hình, hãy xem GPT-6.1 Terra là gì.
API hỗ trợ những gì
| Tính năng | GPT-6.1 Terra |
|---|---|
| ID mô hình | gpt-6.1-terra (một snapshot) |
| Endpoint | Responses, Chat Completions, Batch |
| Không hỗ trợ | Realtime, Live, Assistants, fine-tuning, đầu ra dự đoán |
| Đầu vào | Văn bản và hình ảnh |
| Đầu ra | Văn bản |
| Cửa sổ ngữ cảnh | 1.050.000 token (922.000 đầu vào, 128.000 đầu ra) |
| Mức nỗ lực suy luận | none, low, medium (mặc định), high, xhigh, max |
| Tính năng | Streaming, đầu ra có cấu trúc, gọi hàm, prompt caching |
| Công cụ (chỉ Responses) | web_search, file_search, computer_use, code_interpreter, hosted_shell, apply_patch, skills, mcp, tool_search, image_generation |
Nguồn: trang mô hình GPT-6.1 Terra của OpenAI. Các công cụ được host cần Responses API, vì vậy hãy dùng nó cho công việc mới.
Bước 1: lấy khóa API
Tạo một khóa trong bảng điều khiển nền tảng OpenAI và thêm thanh toán. Không có gói miễn phí cho Terra: gói ChatGPT Plus hoặc Pro cho bạn dùng Terra bên trong ChatGPT Work và Codex, nhưng không cấp khóa API. Hướng dẫn của chúng tôi về liệu GPT-6.1 Terra có miễn phí không giải thích sự khác biệt.
Xuất nó để các ví dụ bên dưới có thể đọc được:
export OPENAI_API_KEY="sk-..."
Giới hạn tốc độ phụ thuộc vào hạng sử dụng của bạn. Trang mô hình liệt kê 5.000 yêu cầu và 1 triệu token mỗi phút ở hạng Build, 10.000 và 4 triệu ở hạng Launch, và 15.000 và 40 triệu ở hạng Grow.
Bước 2: gửi yêu cầu đầu tiên
Với curl, gọi Responses API:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-terra",
"reasoning": { "effort": "low" },
"input": "Summarize the difference between PUT and PATCH in two sentences."
}'
Trong Python với SDK chính thức:
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "low"},
input="Summarize the difference between PUT and PATCH in two sentences.",
)
print(response.output_text)
print(response.usage)
Trong Node:
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-6.1-terra",
reasoning: { effort: "low" },
input: "Summarize the difference between PUT and PATCH in two sentences.",
});
console.log(response.output_text);
console.log(response.usage);
In usage ngay từ đầu. Nó cho bạn biết token đầu vào, được cache và đầu ra, và token suy luận được tính như đầu ra.
Bước 3: chọn mức nỗ lực suy luận
Terra hỗ trợ sáu mức nỗ lực. Mặc định là medium.
| Mức nỗ lực | Dùng cho |
|---|---|
none |
Phân loại, trích xuất, định dạng; đầu ra tất định |
low |
Câu trả lời ngắn, gọi công cụ đơn giản, hầu hết công việc kiểu trò chuyện |
medium |
Mặc định; viết mã tổng quát và các bước agent |
high / xhigh |
Suy luận nhiều bước khó hơn |
max |
Cài đặt benchmark; các tác vụ khó nhất, chậm nhất và đắt nhất |
Hai điểm nổi bật.
none được hỗ trợ. GPT-6.1 Sol đã loại bỏ nó, vì vậy đây là một trong những khác biệt thực tế giữa hai mô hình. Một nhà phát triển trên diễn đàn cộng đồng của OpenAI báo cáo rằng với reasoning.effort: "none", Terra chấp nhận lại temperature và top_p. Đối với một pipeline dán nhãn hoặc trích xuất dữ liệu với khối lượng lớn, none cho bạn chi phí thấp nhất mỗi lần gọi và đầu ra có thể lặp lại.
Mức nỗ lực thấp cải thiện nhiều nhất. Trong bài kiểm tra tính xác thực nội bộ của OpenAI, tỷ lệ lỗi của Terra ở mức nỗ lực thấp giảm từ 53.6% trên GPT-5.6 Terra xuống 16.7%. Artificial Analysis cũng đo được mức cải thiện lớn hơn so với GPT-5.6 Terra ở các mức nỗ lực thấp hơn (7 đến 13 điểm) so với ở mức max (6 điểm). Nếu bạn chạy GPT-5.6 Terra ở high để có chất lượng chấp nhận được, hãy thử low hoặc medium trên 6.1 Terra trước khi cho rằng bạn cần cùng cài đặt.
Bước 4: sử dụng công cụ, bao gồm computer use
OpenAI quảng bá bản phát hành này xoay quanh “computer use nhanh và mạnh mẽ với mức giá thấp hơn.” Computer use, web search, file search và các công cụ được host khác có sẵn trên Responses API. Một lệnh gọi web search trông như sau:
response = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "low"},
tools=[{"type": "web_search"}],
input="What changed in the latest OpenAPI Specification release?",
)
print(response.output_text)
Gọi hàm và đầu ra có cấu trúc hoạt động như trên các mô hình GPT-6 khác: định nghĩa schema hàm của bạn trong tools, hoặc truyền một JSON schema trong cài đặt định dạng văn bản, và xác thực những gì trả về. Để xem sâu hơn về computer use với một ứng dụng thực tế, hướng dẫn computer use GPT-6 Astra của chúng tôi cũng áp dụng cho Terra, với mức giá mỗi token bằng một phần mười của Astra.
Bước 5: kiểm soát chi phí
Mức giá của Terra vốn đã thấp, và bốn cài đặt cắt giảm chúng hơn nữa:
- Prompt caching là tự động. Đầu vào được cache có giá $0.05 mỗi triệu so với $1 cho đầu vào mới. Giữ nội dung ổn định (system prompt, schema công cụ, tài liệu tham chiếu) ở đầu prompt. Ghi cache có giá $1.25 mỗi triệu cho thời gian lưu 30 phút, hoặc $2.50 cho 12 giờ. Xem hướng dẫn prompt caching GPT-6 của chúng tôi.
- Batch giảm một nửa mọi mức giá cho các tác vụ bất đồng bộ: $0.50 đầu vào, $2.50 đầu ra. Hướng dẫn OpenAI Batch API của chúng tôi trình bày toàn bộ luồng.
- Flex cho cùng mức giá một nửa trên các yêu cầu thông thường với
service_tier: "flex", đổi lại phản hồi chậm hơn và đôi khi gặp lỗi 429. - Ngưỡng 272K. Các prompt trên 272K token đầu vào tính toàn bộ yêu cầu ở mức 2x giá đầu vào và cache, và 1.5x giá đầu ra. Nếu bạn gần chạm, hãy cắt bớt ngữ cảnh truy xuất thay vì vượt qua nó.
Chế độ Fast đi theo hướng ngược lại: gấp 2 lần mức giá Standard ($2 đầu vào, $10 đầu ra) để có phản hồi nhanh hơn. Hướng dẫn định giá GPT-6.1 Terra có mọi mức giá trong một bảng.
Di chuyển từ gpt-5.6-terra
Việc thay đổi ID mô hình chỉ là một dòng. Đây là những điều cần kiểm tra xung quanh nó:
- Giá. Đầu vào giảm từ $2 xuống $1, đầu vào được cache từ $0.20 xuống $0.05, đầu ra từ $12 xuống $5. Cập nhật mọi bảng điều khiển chi phí hoặc cảnh báo ngân sách hard-code mức giá.
- Cài đặt mức nỗ lực. Kiểm thử lại ở mức nỗ lực thấp hơn. Chất lượng ở
lowthay đổi nhiều nhất. - Mốc kiến thức. Của Terra là ngày 1 tháng 6 năm 2026. Các prompt giả định mốc cũ hơn, hoặc các bài kiểm thử có đáp án mong đợi nhạy cảm với ngày tháng, có thể thay đổi.
- Độ dài và định dạng đầu ra. Một mô hình mới có thể viết câu trả lời dài hơn hoặc ngắn hơn. Kiểm tra
usage.output_tokensvà mọi parser mong đợi định dạng cố định; dùng đầu ra có cấu trúc khi hình dạng quan trọng. - Tốc độ. OpenAI nói Terra hoàn thành tác vụ nhanh hơn trung bình hơn 3 lần so với Astra và GPT-6.1 Sol. Timeout được tinh chỉnh cho các mô hình chậm hơn thì vẫn ổn, nhưng logic thử lại và polling được xây dựng quanh việc chờ lâu có thể giờ đây gây lãng phí.
- Codex. Nếu nhóm của bạn dùng Codex, Terra cần Codex CLI 0.159.0 trở lên:
codex -m gpt-6.1-terra.
OpenAI chưa công bố ngày ngừng hỗ trợ cho GPT-5.6 Terra, vì vậy bạn có thể chạy cả hai song song trong khi so sánh.
Để coding agent của bạn chứng minh việc di chuyển với Apidog CLI
Các bước 1 đến 6 chính xác là kiểu kiểm tra bạn không nên làm thủ công. Hướng coding agent của bạn đến Apidog CLI và nó có thể xây dựng bài kiểm thử, chạy trên cả hai mô hình và cho bạn biết điều gì đã thay đổi.
Thiết lập một lần:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Sau đó đưa cho Claude Code, Codex hoặc Cursor một prompt:
In Apidog project <id>, add POST https://api.openai.com/v1/responses as an endpoint.
Create a test case that sends my production prompt with model {{MODEL}} and reasoning
effort low, and asserts: status 200, output_text not empty, output matches our JSON
schema, usage.output_tokens under 3000. Run it with MODEL=gpt-5.6-terra and again with
MODEL=gpt-6.1-terra against the <env> environment, then compare tokens and failures.
Agent đọc từng schema, xác thực payload của nó và chạy test case hai lần:
apidog cli-schema get endpoint-create
apidog endpoint create --project <id> --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "MODEL=gpt-5.6-terra" -r cli,json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "MODEL=gpt-6.1-terra" -r cli,json
Giữ khóa OpenAI của bạn trong môi trường Apidog. Khi lượt chạy Terra vượt qua, hãy thêm nó vào CI với -r junit để một thay đổi prompt hoặc mô hình sau này không thể phá vỡ hợp đồng một cách âm thầm; hướng dẫn CI/CD Apidog CLI của chúng tôi có tệp pipeline, và Apidog CLI trong Codex đề cập đến thiết lập Codex.
Câu hỏi thường gặp
ID mô hình của GPT-6.1 Terra là gì? gpt-6.1-terra. Có một snapshot, và nó cũng là mặc định.
GPT-6.1 Terra có hoạt động với Chat Completions không? Có. Nó hỗ trợ Responses, Chat Completions và Batch. Các công cụ được host như web search và computer use cần Responses API.
Tôi có thể đặt temperature trên GPT-6.1 Terra không? Một báo cáo cộng đồng nói có với reasoning.effort: "none". Ở các mức nỗ lực khác, hãy kiểm tra trang mô hình trước khi gửi cài đặt lấy mẫu.
GPT-6.1 Terra có hỗ trợ Realtime API không? Không. Realtime, Live, Assistants và fine-tuning không được hỗ trợ.
Giới hạn tốc độ của GPT-6.1 Terra là gì? Nó phụ thuộc vào hạng của bạn: từ 5.000 yêu cầu và 1 triệu token mỗi phút ở hạng Build lên đến 15.000 và 40 triệu ở hạng Grow.
Bước tiếp theo
Hoán đổi ID mô hình trên một endpoint, kiểm thử lại ở mức nỗ lực thấp hơn, và để agent của bạn so sánh hai lượt chạy bằng Apidog CLI. Nếu các con số giữ nguyên, hãy triển khai. Không chắc Terra hay Sol phù hợp với khối lượng công việc của bạn? Đọc GPT-6.1 Terra so với GPT-6.1 Sol.