gemini-3.1-pro-preview，同時支援 OpenAI 相容端點。
核心能力
- Gemini 原生 API - 使用 generateContent 與 content parts
- 系統指令 - 支援 systemInstruction
- 生成控制 - 使用 generationConfig
- OpenAI 相容 - 也可透過 Chat Completions 呼叫
快速範例
Gemini 原生 API
- cURL
- Python
curl "https://api.mixroute.ai/v1/models/gemini-3.1-pro-preview:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain quantum entanglement in simple terms."
}
]
}
],
"generationConfig": {
"temperature": 1,
"topP": 1
}
}'
import requests
response = requests.post(
"https://api.mixroute.ai/v1/models/gemini-3.1-pro-preview:generateContent",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={'contents': [{'role': 'user',
'parts': [{'text': 'Explain quantum entanglement in simple terms.'}]}],
'generationConfig': {'temperature': 1, 'topP': 1}},
)
print(response.json())
OpenAI 相容 API
- cURL
- Python
- Streaming
curl "https://api.mixroute.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro-preview",
"messages": [
{
"role": "user",
"content": "Explain quantum entanglement in simple terms."
}
],
"max_tokens": 256
}'
from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")
response = client.chat.completions.create(
model="gemini-3.1-pro-preview",
messages=[{"role": "user", "content": "Explain quantum entanglement in simple terms."}],
max_tokens=256,
)
print(response.choices[0].message.content)
from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")
stream = client.chat.completions.create(
model="gemini-3.1-pro-preview",
messages=[{"role": "user", "content": "Write a short poem about the sea."}],
max_tokens=256,
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
參數
Gemini 原生 API
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
contents | array | 是 | 由 role 與 parts 組成的對話內容。 |
systemInstruction | object | 否 | 包含內容片段的系統指令。 |
generationConfig | object | 否 | temperature、topP 等生成參數。 |
safetySettings | array | 否 | 內容安全設定。 |
OpenAI 相容 API
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | 固定為 gemini-3.1-pro-preview。 |
messages | array | 是 | 包含 role 與 content 的對話訊息。 |
max_tokens | integer | 否 | 最大生成 token 數。 |
stream | boolean | 否 | 啟用 SSE 串流輸出，預設 false。 |
temperature | number | 否 | 模型支援時用於控制取樣隨機性。 |
top_p | number | 否 | 模型支援時使用的核取樣閾值。 |
stop | string | array | 否 | 觸發停止生成的序列。 |
tools | array | 否 | OpenAI 相容工具定義。 |