Gemini Chat 思考模式 2
本页保留 Gemini 3.1 Pro 的兼容参数示例。网关对 reasoning_effort/extra_body 的映射需按实际分组确认;Gemini 3.8 Flash 的明确思考控制请使用 原生 thinkingConfig.thinkingLevel(low/medium/high)。
在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token
Authorization: Bearer ********************
请求参数
请求示例代码
curl --no-buffer --fail-with-body --request POST 'https://api.apizt.com/v1/chat/completions' \
--header "Authorization: Bearer ${tokenba_API_KEY}" \
--header 'Content-Type: application/json' \
--data-raw '{
"messages": [
{
"role": "user",
"content": "你好呀?"
}
],
"model": "gemini-3.1-pro-preview",
"stream": true,
"extra_body": {
"google": {
"thinking_config": {
"include_thoughts": true,
"thinking_level": "low"
}
}
}
}'
async function main() {
const headers = { Authorization: "Bearer " + process.env.tokenba_API_KEY };
headers["Content-Type"] = "application/json";
const body = JSON.stringify({
"messages": [
{
"role": "user",
"content": "你好呀?"
}
],
"model": "gemini-3.1-pro-preview",
"stream": true,
"extra_body": {
"google": {
"thinking_config": {
"include_thoughts": true,
"thinking_level": "low"
}
}
}
});
const response = await fetch("https://api.apizt.com/v1/chat/completions", { method: "POST", headers, body });
if (!response.ok) throw new Error("HTTP " + response.status + ": " + await response.text());
const reader = response.body.getReader();
const decoder = new TextDecoder();
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
process.stdout.write(decoder.decode(value, { stream: true }));
}
process.stdout.write(decoder.decode());
} finally { reader.releaseLock(); }
}
main().catch(console.error);
import okhttp3.*;
import java.io.File;
class Example {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
RequestBody body = RequestBody.create(MediaType.parse("application/json"), "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}");
Request.Builder request = new Request.Builder().url("https://api.apizt.com/v1/chat/completions").header("Authorization", "Bearer " + System.getenv("tokenba_API_KEY"));
request.method("POST", body);
try (Response response = client.newCall(request.build()).execute()) {
if (!response.isSuccessful()) throw new Exception("HTTP " + response.code());
System.out.println(response.body().string());
}
}
}
import Foundation
var request = URLRequest(url: URL(string: "https://api.apizt.com/v1/chat/completions")!)
request.httpMethod = "POST"
request.setValue("Bearer " + ProcessInfo.processInfo.environment["tokenba_API_KEY"]!, forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}".data(using: .utf8)
let (data, response) = try await URLSession.shared.data(for: request)
print((response as? HTTPURLResponse)?.statusCode ?? 0)
print(String(data: data, encoding: .utf8) ?? "")
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("POST", "https://api.apizt.com/v1/chat/completions", bytes.NewBufferString("{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}"))
_ = bytes.MinRead
if err != nil { panic(err) }
req.Header.Set("Authorization", "Bearer " + os.Getenv("tokenba_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }; defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.Status, string(data))
}
<?php
$headers = ["Authorization: Bearer " . getenv("tokenba_API_KEY")];
$headers[] = "Content-Type: application/json";
$body = <<<'JSON'
{
"messages": [
{
"role": "user",
"content": "你好呀?"
}
],
"model": "gemini-3.1-pro-preview",
"stream": true,
"extra_body": {
"google": {
"thinking_config": {
"include_thoughts": true,
"thinking_level": "low"
}
}
}
}
JSON;
$curl = curl_init('https://api.apizt.com/v1/chat/completions');
curl_setopt_array($curl, [CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $body]);
$result = curl_exec($curl);
if ($result === false) throw new Exception(curl_error($curl));
echo $result;
curl_close($curl);
import os
import requests
headers = {"Authorization": "Bearer " + os.environ["tokenba_API_KEY"]}
payload = {'messages': [{'role': 'user', 'content': '你好呀?'}],
'model': 'gemini-3.1-pro-preview',
'stream': True,
'extra_body': {'google': {'thinking_config': {'include_thoughts': True,
'thinking_level': 'low'}}}}
response = requests.request('POST', 'https://api.apizt.com/v1/chat/completions', headers=headers, json=payload, timeout=120, stream=True)
response.raise_for_status()
response.encoding = "utf-8"
for line in response.iter_lines(decode_unicode=True):
print(line, flush=True)
POST /v1/chat/completions HTTP/1.1
Host: api.apizt.com
Authorization: Bearer YOUR_tokenba_API_KEY
Content-Type: application/json
{
"messages": [
{
"role": "user",
"content": "你好呀?"
}
],
"model": "gemini-3.1-pro-preview",
"stream": true,
"extra_body": {
"google": {
"thinking_config": {
"include_thoughts": true,
"thinking_level": "low"
}
}
}
}
#include <curl/curl.h>
#include <stdlib.h>
#include <stdio.h>
int main(void) {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL *curl = curl_easy_init();
if (!curl) return 1;
char auth[4096];
snprintf(auth, sizeof(auth), "Authorization: Bearer %s", getenv("tokenba_API_KEY"));
struct curl_slist *headers = curl_slist_append(NULL, auth);
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}");
curl_easy_setopt(curl, CURLOPT_URL, "https://api.apizt.com/v1/chat/completions");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
CURLcode result = curl_easy_perform(curl);
curl_slist_free_all(headers); curl_easy_cleanup(curl); curl_global_cleanup();
return result == CURLE_OK ? 0 : 1;
}
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.apizt.com/v1/chat/completions");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("tokenba_API_KEY"));
request.Content = new StringContent("{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
#import <Foundation/Foundation.h>
int main(void) {
@autoreleasepool {
dispatch_semaphore_t done = dispatch_semaphore_create(0);
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.apizt.com/v1/chat/completions"]];
request.HTTPMethod = @"POST";
NSDictionary *env = [[NSProcessInfo processInfo] environment];
[request setValue:[@"Bearer " stringByAppendingString:env[@"tokenba_API_KEY"]] forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
request.HTTPBody = [@"{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}" dataUsingEncoding:NSUTF8StringEncoding];
[[[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
if (error) { NSLog(@"%@", error); dispatch_semaphore_signal(done); return; }
NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
dispatch_semaphore_signal(done);
}] resume];
dispatch_semaphore_wait(done, DISPATCH_TIME_FOREVER);
}
return 0;
}
require "net/http"
require "json"
uri = URI("https://api.apizt.com/v1/chat/completions")
request = Net::HTTPGenericRequest.new("POST", true, true, uri.request_uri)
request["Authorization"] = "Bearer " + ENV.fetch("tokenba_API_KEY")
request["Content-Type"] = "application/json"
request.body = "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}"
puts Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request).body }
open Lwt.Infix
let () =
let headers = Cohttp.Header.init_with "Authorization" ("Bearer " ^ Sys.getenv "tokenba_API_KEY") in
let data = {|{
"messages": [
{
"role": "user",
"content": "你好呀?"
}
],
"model": "gemini-3.1-pro-preview",
"stream": true,
"extra_body": {
"google": {
"thinking_config": {
"include_thoughts": true,
"thinking_level": "low"
}
}
}
}|} in
let headers = Cohttp.Header.add headers "Content-Type" "application/json" in
Lwt_main.run (
Cohttp_lwt_unix.Client.call ~headers ~body:(Cohttp_lwt.Body.of_string data) `POST (Uri.of_string "https://api.apizt.com/v1/chat/completions") >>= fun (_, body) ->
Cohttp_lwt.Body.to_string body >|= print_endline
)
import "dart:io";
import "package:http/http.dart" as http;
Future<void> main() async {
final headers = {"Authorization": "Bearer ${Platform.environment['tokenba_API_KEY']}"};
final request = http.Request("POST", Uri.parse("https://api.apizt.com/v1/chat/completions"));
request.headers.addAll(headers);
request.headers["Content-Type"] = "application/json";
request.body = "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}";
final response = await request.send();
print(response.statusCode);
print(await response.stream.bytesToString());
}
library(httr)
headers <- c(Authorization = paste("Bearer", Sys.getenv("tokenba_API_KEY")))
headers["Content-Type"] <- "application/json"
body <- "{\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"你好呀?\"\n }\n ],\n \"model\": \"gemini-3.1-pro-preview\",\n \"stream\": true,\n \"extra_body\": {\n \"google\": {\n \"thinking_config\": {\n \"include_thoughts\": true,\n \"thinking_level\": \"low\"\n }\n }\n }\n}"
response <- VERB("POST", "https://api.apizt.com/v1/chat/completions", add_headers(.headers = headers), body = body)
stop_for_status(response)
cat(content(response, "text", encoding = "UTF-8"))
返回响应
{
"id": "chatcmpl-123",
"object": "chat.completion",
"created": 1677652288,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\nHello there, how may I assist you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 9,
"completion_tokens": 12,
"total_tokens": 21
}
}
示例先设置 tokenba_API_KEY。JavaScript 使用 Node.js 20+,Python 安装 requests。流式示例的 Python 与 JavaScript 会逐段输出事件数据。代码中的 ID、文件名与令牌须替换为自己的值。
当前示例模型 ID 为 gemini-3.1-pro-preview,对应 apizt 价格页所列接口协议;请为令牌选择包含该型号的分组。
当前模型与版本
依据 apizt 价格页,同步于 。以下型号按目录声明的协议与本页用途筛选;不代表所有参数和功能通用。切换前请核对型号说明、令牌分组与参数差异。Gemini 原生接口需同时替换 URL 中的模型 ID。
| 模型 ID | 能力标签 | 支持分组 |
|---|---|---|
gemini-3.8-flash | 对话,识图,工具 | 分组(9)
|
gemini-3.1-pro-preview | 对话,思考,多模态 | 分组(9)
|
gemini-3.5-flash-lite | 对话,工具,识图 | 分组(9)
|
gemini-3-flash-preview | 对话,识图,工具 | 分组(9)
|
gemini-3.7-flash | 对话,识图,工具 | 分组(9)
|
gemini-3.1-flash-lite | 对话,工具,识图 | 分组(9)
|
gemini-3.5-flash | 对话,工具,识图 | 分组(9)
|
gemini-2.5-pro | 对话,识图,思考 | 分组(8)
|
共列入 16 个候选型号。查看完整模型、版本与接口目录。