Text
Grok 4.7
Gọi Grok 4.7 bằng định dạng gốc Chat Completions, Responses hoặc Messages. Tham số, truyền theo luồng, mức sử dụng và giới hạn hiện tại.
Sử dụng grok-4.7 với một trong ba định dạng dưới đây. Bạn xác thực bằng khóa API SeedRouter của mình. Trang mô hình có Playground và giá token hiện tại; hướng dẫn giá giải thích đầu vào được lưu đệm và suy luận.
Bắt đầu nhanh
curl https://api.seedrouter.ai/v1/responses \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.7","input":"What is 2 + 2?","reasoning":{"effort":"low"},"max_output_tokens":64,"store":false}'Phản hồi JSON chứa các mục output và usage. Khi tạo lịch sử hội thoại, hãy giữ lại mọi mục đầu ra, bao gồm cả các mục suy luận và công cụ.
Định dạng yêu cầu
| Định dạng | Điểm cuối | Trường bắt buộc |
|---|---|---|
| Responses | POST /v1/responses | model, input |
| Chat Completions | POST /v1/chat/completions | model, messages |
| Messages | POST /v1/messages | model, messages, max_tokens |
Sử dụng Content-Type: application/json và Authorization: Bearer $SEEDROUTER_API_KEY. Ứng dụng khách Messages cũng có thể gửi anthropic-version: 2023-06-01.
Tham số và ràng buộc
Đặc tả OpenAPI chứa đầy đủ lược đồ yêu cầu và phản hồi lồng nhau. Các bảng dưới đây liệt kê mọi trường yêu cầu cấp cao nhất được hỗ trợ. Trường không xác định và tham số mà mô hình này chính thức bỏ qua sẽ bị loại bỏ. Tham số được hỗ trợ nhưng có giá trị không hợp lệ vẫn là không hợp lệ.
Các trường tùy chọn cho phép null chấp nhận null được chỉ định rõ; bỏ qua trường sẽ dùng giá trị mặc định của API. Playground ẩn user và cố định model thành grok-4.7. Ứng dụng khách API vẫn có thể gửi user.
- Ngữ cảnh: 500.000 token, bao gồm hội thoại và đầu ra.
- Mức suy luận:
low,medium,high,xhigh; mặc định làhigh. max_completion_tokensvàmax_output_tokensmặc định là 128.000 token đầu ra hiển thị. Token suy luận và lệnh gọi hàm nằm ngoài giới hạn đầu ra hiển thị này. Đây là giá trị mặc định, không phải khẳng định về khả năng đầu ra tối đa.- Giới hạn đầu ra phải là số nguyên dương. API cũng áp dụng trần an toàn số nguyên hiện có là 1.073.741.823; giới hạn dung lượng ngữ cảnh vẫn áp dụng.
temperature: từ 0 đến 2, mặc định 1.top_p: lớn hơn 0 và không quá 1, mặc định 1. Với Responses,min_p: từ 0 đến 1;top_k: số nguyên ít nhất là 1.- Tối đa 350 định nghĩa công cụ.
stream_optionsyêu cầustream: true. - Không thể kết hợp
instructionsvàprevious_response_id. Tóm tắt suy luận luôn ở mức chi tiết.
Tham số Responses
| Trường | Kiểu | Quy tắc |
|---|---|---|
include | mảng hoặc null | Mảng các trường phản hồi bổ sung cần đưa vào. |
input (bắt buộc) | đối tượng hoặc dạng khác được hỗ trợ | Chuỗi văn bản hoặc mảng đầy đủ các mục đầu vào. |
instructions | chuỗi hoặc null | Chỉ dẫn hệ thống; không thể kết hợp với previous_response_id. |
max_output_tokens | số nguyên hoặc null | Giới hạn đầu ra hiển thị; mặc định 128.000. |
max_turns | số nguyên hoặc null | Số lượt tối đa của tác tử, ở dạng số nguyên. |
min_p | số hoặc null | Số từ 0 đến 1. |
model (bắt buộc) | chuỗi | Cố định thành grok-4.7. |
parallel_tool_calls | boolean hoặc null | Boolean; mặc định true. |
previous_response_id | chuỗi hoặc null | ID phản hồi dạng chuỗi; hiện chưa thể tiếp tục theo ID. |
prompt_cache_key | chuỗi hoặc null | Khóa bộ nhớ đệm dạng chuỗi. |
reasoning | đối tượng | Cấu hình suy luận; mức mặc định là high. |
reasoning_effort | chuỗi hoặc null | low, medium, high, xhigh; mặc định high. |
safety_identifier | chuỗi hoặc null | Mã định danh an toàn tùy chọn do bên gọi cung cấp. |
search_parameters | đối tượng | Cấu hình tìm kiếm. |
service_tier | chuỗi | auto, default, priority, fast; priority và fast tăng gấp đôi đơn giá token. |
store | boolean hoặc null | Boolean; mặc định true. Hiện chưa thể thực hiện các thao tác với phản hồi đã lưu. |
stream | boolean hoặc null | Boolean; mặc định false. |
temperature | số hoặc null | Số từ 0 đến 2; mặc định 1. |
text | đối tượng | Cấu hình phản hồi văn bản, bao gồm format. |
tool_choice | đối tượng hoặc dạng khác được hỗ trợ | Tự động, tắt, bắt buộc hoặc một công cụ được chọn; cú pháp phụ thuộc định dạng. |
tools | mảng hoặc null | Định nghĩa công cụ; tối đa 350. |
top_k | số nguyên hoặc null | Số nguyên; Responses yêu cầu ít nhất là 1. |
top_p | số hoặc null | Số lớn hơn 0 và không quá 1; mặc định 1. |
user | chuỗi hoặc null | Mã định danh tùy chọn do bên gọi cung cấp; bị ẩn trong Playground. |
Tham số Chat Completions
| Trường | Kiểu | Quy tắc |
|---|---|---|
deferred | boolean hoặc null | Boolean; mặc định false. Hiện chưa hỗ trợ hoàn tất trì hoãn. |
max_completion_tokens | số nguyên hoặc null | Giới hạn đầu ra hiển thị; mặc định 128.000. |
max_tokens | số nguyên hoặc null | Giới hạn dương cho đầu ra hiển thị. Bắt buộc với Messages. |
messages (bắt buộc) | mảng | Các tin nhắn hội thoại theo định dạng này. |
model (bắt buộc) | chuỗi | Cố định thành grok-4.7. |
n | số nguyên hoặc null | Số nguyên ít nhất là 1; mặc định 1. |
parallel_tool_calls | boolean hoặc null | Boolean; mặc định true. |
prompt_cache_key | chuỗi hoặc null | Khóa bộ nhớ đệm dạng chuỗi. |
reasoning_effort | chuỗi hoặc null | low, medium, high, xhigh; mặc định high. |
response_format | đối tượng hoặc dạng khác được hỗ trợ | Đầu ra văn bản, đối tượng JSON hoặc đầu ra theo lược đồ JSON. |
safety_identifier | chuỗi hoặc null | Mã định danh an toàn tùy chọn do bên gọi cung cấp. |
search_parameters | đối tượng | Cấu hình tìm kiếm. |
seed | số nguyên hoặc null | Giá trị khởi tạo lấy mẫu dạng số nguyên. |
service_tier | chuỗi | auto, default, priority, fast; priority và fast tăng gấp đôi đơn giá token. |
stream | boolean hoặc null | Boolean; mặc định false. |
stream_options | đối tượng | Tùy chọn truyền theo luồng; yêu cầu stream: true. |
temperature | số hoặc null | Số từ 0 đến 2; mặc định 1. |
tool_choice | đối tượng hoặc dạng khác được hỗ trợ | Tự động, tắt, bắt buộc hoặc một công cụ được chọn; cú pháp phụ thuộc định dạng. |
tools | mảng hoặc null | Định nghĩa công cụ; tối đa 350. |
top_p | số hoặc null | Số lớn hơn 0 và không quá 1; mặc định 1. |
user | chuỗi hoặc null | Mã định danh tùy chọn do bên gọi cung cấp; bị ẩn trong Playground. |
web_search_options | đối tượng | Tùy chọn tìm kiếm cho định dạng tương thích. |
Tham số Messages
| Trường | Kiểu | Quy tắc |
|---|---|---|
max_tokens (bắt buộc) | số nguyên | Giới hạn dương cho đầu ra hiển thị. Bắt buộc với Messages. |
messages (bắt buộc) | mảng | Các tin nhắn hội thoại theo định dạng này. |
metadata | đối tượng | Đối tượng siêu dữ liệu của Messages. |
model (bắt buộc) | chuỗi | Cố định thành grok-4.7. |
stop_sequences | mảng hoặc null | Mảng các chuỗi dừng. |
stream | boolean hoặc null | Boolean; mặc định false. |
system | đối tượng hoặc dạng khác được hỗ trợ | Chuỗi hệ thống hoặc các khối nội dung. |
temperature | số hoặc null | Số từ 0 đến 2; mặc định 1. |
tool_choice | đối tượng hoặc dạng khác được hỗ trợ | Tự động, tắt, bắt buộc hoặc một công cụ được chọn; cú pháp phụ thuộc định dạng. |
tools | mảng hoặc null | Định nghĩa công cụ; tối đa 350. |
top_k | số nguyên hoặc null | Số nguyên; Responses yêu cầu ít nhất là 1. |
top_p | số hoặc null | Số lớn hơn 0 và không quá 1; mặc định 1. |
Truyền theo luồng
Đặt stream thành true. Chat phát các đoạn hoàn tất; Responses phát các sự kiện phản hồi có tên; Messages phát các sự kiện tin nhắn và khối nội dung. Hãy đọc sự kiện sử dụng cuối cùng cùng với các phần văn bản tăng thêm. Lệnh gọi công cụ và suy luận có thể là những mục đầu ra riêng; khi giữ lại lịch sử, đừng rút gọn luồng chỉ còn văn bản hiển thị.
{
"model": "grok-4.7",
"input": "Explain a mutex in one sentence.",
"reasoning": { "effort": "low" },
"max_output_tokens": 128,
"store": false,
"stream": true
}Công cụ và đầu ra có cấu trúc
Sử dụng định nghĩa công cụ tương ứng với định dạng bạn chọn. Chat dùng response_format; Responses dùng text.format. Hàm, tìm kiếm web, tìm kiếm X, trình thông dịch mã và lệnh gọi MCP đã được thử nghiệm với mô hình này. Shell trả về lệnh gọi do ứng dụng khách thực thi; nó không tự động chạy lệnh trên máy tính của bạn. Lược đồ đầy đủ cũng mô tả các kiểu công cụ khác; chỉ có mục trong lược đồ chưa phải là bằng chứng rằng một dịch vụ bên ngoài cụ thể đã được cấu hình.
{
"model": "grok-4.7",
"input": "Use the code interpreter once to compute 13*17. Return the number.",
"tools": [{ "type": "code_interpreter" }],
"tool_choice": "required",
"max_turns": 1,
"reasoning": { "effort": "low" },
"max_output_tokens": 32,
"store": false
}Mức sử dụng công cụ được tính phí riêng với token. Tìm kiếm web và trình thông dịch mã dùng số lần gọi. Tìm kiếm X dùng số bài đăng và hồ sơ được truy xuất, bao gồm cả các mục được truy xuất lặp lại; số lệnh gọi tìm kiếm X không phải đơn vị tính phí. Hãy kiểm tra usage.server_side_tool_usage_details và bản ghi sử dụng trong tài khoản.
Mức sử dụng và giá
Giá phụ thuộc tổng độ dài đầu vào. Dưới 200.000 token đầu vào, hãy dùng mức chuẩn. Từ 200.000 token trở lên, mức ngữ cảnh dài áp dụng cho toàn bộ yêu cầu; đầu vào được lưu đệm được tính khi chọn mức giá. service_tier: "priority" và "fast" tăng gấp đôi đơn giá token ở cả hai mức. auto và default chọn dịch vụ chuẩn. Phí công cụ được tính riêng và không tăng gấp đôi theo hệ số token này.
| Định dạng | Cách tính đầu vào | Cách tính đầu ra |
|---|---|---|
| Responses | input_tokens bao gồm input_tokens_details.cached_tokens | output_tokens bao gồm suy luận; không cộng lại phần chi tiết suy luận |
| Chat | prompt_tokens bao gồm prompt_tokens_details.cached_tokens | xAI báo riêng completion_tokens hiển thị; tổng đầu ra tính phí là total_tokens - prompt_tokens, bao gồm suy luận |
| Messages | input_tokens không bao gồm cache_read_input_tokens; cộng các trường bộ nhớ đệm để có tổng đầu vào | output_tokens là tổng đầu ra |
Phản hồi công khai chứa bộ đếm sử dụng, không chứa các trường tiền phí. Bản ghi sử dụng cho biết khoản phí cuối cùng. Yêu cầu thất bại không bị tính phí.
Lịch sử hội thoại và giới hạn hiện tại
Để tiếp tục không lưu trạng thái, hãy gửi đầu vào trước đó, mọi mục đầu ra đã nhận và tin nhắn tiếp theo của người dùng thành input mới. Với Chat hoặc Messages, gửi toàn bộ lịch sử tin nhắn theo định dạng đó. Giữ nguyên các mục suy luận được mã hóa và công cụ khi chúng được trả về.
Dịch vụ hiện tại không thể tiếp tục bằng previous_response_id, truy xuất hoặc xóa phản hồi đã lưu, liệt kê các mục đầu vào đã lưu hay trả về kết quả hoàn tất Chat trì hoãn. store: true có thể được chấp nhận khi tạo, nhưng điều đó không chứng minh hỗ trợ lưu hoặc truy xuất phản hồi. Các trường này vẫn có trong hợp đồng chính thức và Playground; giới hạn này không thay thế định nghĩa hành vi vốn có của chúng.
Tệp đính kèm chưa hoạt động với các đầu vào đã thử nghiệm là văn bản nội tuyến và URL PDF. Yêu cầu tạo ảnh trả về văn bản không có ảnh, còn tìm kiếm công cụ chưa hoàn tất quá trình khám phá ở phía máy chủ. Những khả năng này chưa được xác minh là khả dụng. Tìm kiếm Collections cũng cần tài nguyên collection hợp lệ và chưa được xác minh.
Chat bỏ qua frequency_penalty, presence_penalty, logit_bias, stop, logprobs và top_logprobs. Responses bỏ qua background, context_management, metadata, truncation, logprobs và top_logprobs. Chúng không được chuyển tiếp hoặc cung cấp dưới dạng điều khiển hoạt động.
Lỗi
Yêu cầu không hợp lệ trả về lỗi thay vì câu trả lời hoàn tất. Hãy kiểm tra giá trị các trường và tài liệu tham chiếu lỗi công khai. Yêu cầu trả về lỗi không bị tính phí.