Authentication
- Base URL
https://host.docker.internal:8000- Authorization
Authorization: Bearer YOUR_API_KEY- Content-Type
application/json- Model name
gemini-3.5-flash
Integration protocols
Why this protocol
适合原本使用 Gemini SDK 或 generateContent 接口的用户直接迁移。
Endpoint
POST/v1beta/models/gemini-3.5-flash:generateContent
Authorization: Bearer YOUR_API_KEYContent-Type: application/jsonRequest / Response JSON
// REQUEST
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，世界"
}
]
}
],
"generationConfig": {
"temperature": 0.7,
"topP": 1,
"maxOutputTokens": 4096
},
"tools": []
}// RESPONSE
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Hello from Mix API"
}
]
}
}
],
"modelVersion": "gemini-3.5-flash",
"usageMetadata": {
"promptTokenCount": 8,
"candidatesTokenCount": 16,
"totalTokenCount": 24
}
}Request / Response schema
// INPUT SCHEMA
| Field | Type | Required |
|---|---|---|
| contents | array | Y |
| contents[] | object | Y |
| contents[].role | string | Y |
| contents[].parts | array | Y |
| contents[].parts[] | object | Y |
| contents[].parts[].text | string | Y |
| generationConfig | object | Y |
| generationConfig.temperature | number | Y |
| generationConfig.topP | integer | Y |
| generationConfig.maxOutputTokens | integer | Y |
| tools | array | Y |
// RESPONSE SCHEMA
| Field | Type | Required |
|---|---|---|
| candidates[].content.parts[].text | string | N |
| usageMetadata.promptTokenCount | integer | N |
| usageMetadata.candidatesTokenCount | integer | N |
| usageMetadata.totalTokenCount | integer | N |
Code examples
cURLrequest.sh
curl -X POST "https://host.docker.internal:8000/v1beta/models/gemini-3.5-flash:generateContent" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，世界"
}
]
}
],
"generationConfig": {
"temperature": 0.7,
"topP": 1,
"maxOutputTokens": 4096
},
"tools": []
}'Why this protocol
适合已有 OpenAI SDK、Chat Completions 代码或统一网关接入的用户。
Endpoint
POST/v1/chat/completions
Authorization: Bearer YOUR_API_KEYContent-Type: application/jsonRequest / Response JSON
// REQUEST
{
"model": "gemini-3.5-flash",
"messages": [
{
"content": "你好，世界",
"role": "user"
}
],
"system_instruction": "你是一个严谨的助手。",
"temperature": 0.7,
"top_p": 1,
"max_tokens": 4096,
"stream": false,
"top_k": 40,
"reasoning_effort": "low",
"response_modalities": [
"TEXT"
],
"tools": []
}// RESPONSE
{
"candidates": [
{
"content": {
"parts": [
{
"text": "你好，世界"
}
]
}
}
],
"usageMetadata": {
"promptTokenCount": 8,
"candidatesTokenCount": 16,
"totalTokenCount": 24
}
}Request / Response schema
// INPUT SCHEMA
| Field | Type | Required |
|---|---|---|
| messages | array | Y |
| system_instruction | string | N |
| temperature | number | N |
| top_p | number | N |
| max_tokens | integer | N |
| stream | boolean | N |
| top_k | integer | N |
| reasoning_effort | enum | N |
| response_modalities | array | N |
| tools | array | N |
// RESPONSE SCHEMA
| Field | Type | Required |
|---|---|---|
| candidates[].content.parts[].text | string | N |
| usageMetadata.promptTokenCount | integer | N |
| usageMetadata.candidatesTokenCount | integer | N |
| usageMetadata.totalTokenCount | integer | N |
Code examples
cURLrequest.sh
curl -X POST "https://host.docker.internal:8000/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gemini-3.5-flash",
"messages": [
{
"content": "你好，世界",
"role": "user"
}
],
"system_instruction": "你是一个严谨的助手。",
"temperature": 0.7,
"top_p": 1,
"max_tokens": 4096,
"stream": false,
"top_k": 40,
"reasoning_effort": "low",
"response_modalities": [
"TEXT"
],
"tools": []
}'