跳转到主要内容
POST
/
gemini
/
chat
/
completions
cURL
curl --request POST \
  --url https://api.ttapi.io/gemini/chat/completions \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "model": "<string>",
  "stream": "false"
}
'
{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "你好!很高兴和你聊天。\n\n有什么可以帮你的吗?或者想聊点什么? 😊",
        "role": "assistant"
      }
    }
  ],
  "created": 1757472417,
  "id": "oebAaMTvMfCUjMcP_prYwAs",
  "model": "gemini-2.5-pro",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 21,
    "prompt_tokens": 3,
    "total_tokens": 1466
  }
}
TTAPI中转 Gemini Chat 接口 ,请求 header 使用 TT-API-KEY 进行鉴权,其余所有请求参数及响应参数与官方一致, 具体参考Google官方文档

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
messages
object[]
必填
示例:
[{ "role": "user", "content": "Hello!" }]
model
string
必填

TTAPI 支持使用的模型,详见Gemini支持模型

stream
boolean
默认值:false

是否使用服务器发送的事件逐步传输响应

响应

成功响应(stream=false 返回JSON,stream=true 返回Gemini流式)

choices
object[]
必填

响应结果列表

created
integer
必填

响应创建时间戳(秒)

示例:

1757472417

id
string
必填

请求唯一标识

示例:

"oebAaMTvMfCUjMcP_prYwAs"

model
string
必填

使用的 Gemini 模型版本

示例:

"gemini-2.5-pro"

object
string
必填

响应对象类型

示例:

"chat.completion"

usage
object
必填

token 使用统计

Last modified on March 16, 2026