文本对话
POST
https://ai-api.kkidc.com/v1beta/models/{model}:generateContent
路径格式: /v1beta/models/{model_name}:{action}
可选模型ID例如：
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Path 参数
Body 参数application/json必填
示例
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "hello"
}
]
}
],
"generationConfig": {
"maxOutputTokens": 100
}
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ai-api.kkidc.com/v1beta/models/gemini-2.5-flash:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "hello"
}
]
}
],
"generationConfig": {
"maxOutputTokens": 100
}
}'返回响应
🟢200成功
application/json
Body
示例
{
"candidates": [
{
"content": {
"parts": [
{
"text": "Hello! How can I help you today?"
}
],
"role": "model"
},
"finishReason": "STOP"
}
],
"createTime": "2026-02-02T08:14:42.379547Z",
"modelVersion": "gemini-2.5-flash",
"responseId": "8lyAaZuVF5apmecPvtugMA",
"usageMetadata": {
"candidatesTokenCount": 9,
"candidatesTokensDetails": [
{
"modality": "TEXT",
"tokenCount": 9
}
],
"promptTokenCount": 1,
"promptTokensDetails": [
{
"modality": "TEXT",
"tokenCount": 1
}
],
"thoughtsTokenCount": 22,
"totalTokenCount": 32,
"trafficType": "ON_DEMAND"
}
}🟠429限流
🟠400请求有误
修改于 2026-02-26 06:26:28