外观
Gemini 原生 API
ArcAI 兼容 Google Gemini API 的 v1beta 格式。已经在用 Gemini API 的代码,只需要改 Base URL 和 Key。
| 项目 | 值 |
|---|---|
| Base URL | https://arcnovatech.info |
| 生成内容 | POST /v1beta/models/{model}:generateContent |
| 流式生成 | POST /v1beta/models/{model}:streamGenerateContent?alt=sse |
| 模型列表 | GET /v1beta/models |
| 认证 | 请求头 x-goog-api-key: <你的 ArcAI Key> |
调用示例
bash
curl "https://arcnovatech.info/v1beta/models/gemini-4-argon:generateContent" \
-H "x-goog-api-key: $ARCAI_API_KEY" \
-H "content-type: application/json" \
-d '{
"contents": [{ "role": "user", "parts": [{ "text": "用一句话介绍你自己" }] }]
}'python
# pip install google-genai
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["ARCAI_API_KEY"],
http_options=types.HttpOptions(base_url="https://arcnovatech.info"),
)
resp = client.models.generate_content(
model="gemini-4-argon",
contents="用一句话介绍你自己",
)
print(resp.text)ts
// npm install @google/genai
import { GoogleGenAI } from '@google/genai'
const ai = new GoogleGenAI({
apiKey: process.env.ARCAI_API_KEY,
httpOptions: { baseUrl: 'https://arcnovatech.info' },
})
const resp = await ai.models.generateContent({
model: 'gemini-4-argon',
contents: '用一句话介绍你自己',
})
console.log(resp.text)js
const resp = await fetch(
'https://arcnovatech.info/v1beta/models/gemini-4-argon:generateContent',
{
method: 'POST',
headers: {
'x-goog-api-key': process.env.ARCAI_API_KEY,
'content-type': 'application/json',
},
body: JSON.stringify({
contents: [{ role: 'user', parts: [{ text: '用一句话介绍你自己' }] }],
}),
},
)
const data = await resp.json()
console.log(data.candidates[0].content.parts[0].text)请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
contents | array | 是 | 对话内容。每项包含 role(user / model)和 parts |
systemInstruction | object | 否 | 系统指令,格式 {"parts": [{"text": "..."}]} |
generationConfig | object | 否 | 生成参数,见下表 |
tools | array | 否 | 函数声明等工具。受 工具策略 约束 |
safetySettings | array | 否 | 安全过滤设置,每项包含 category 和 threshold |
generationConfig 常用字段:
| 字段 | 说明 |
|---|---|
temperature | 随机性,范围 0–2 |
topP / topK | 采样参数 |
maxOutputTokens | 最大输出 Token,包含思考消耗的 Token |
stopSequences | 停止序列 |
thinkingConfig | 思考设置,见下文 |
多轮对话和系统指令
json
{
"systemInstruction": { "parts": [{ "text": "你是一名客服,回答简洁。" }] },
"contents": [
{ "role": "user", "parts": [{ "text": "订单 4821 到哪了?" }] },
{ "role": "model", "parts": [{ "text": "请稍等,我帮你查一下。" }] },
{ "role": "user", "parts": [{ "text": "好的" }] }
],
"generationConfig": { "temperature": 0.3, "maxOutputTokens": 2048 }
}思考设置
Gemini 4 模型默认会先思考再回答,思考也计入输出 Token。
- 用
thinkingConfig.thinkingLevel控制思考强度,例如"low"。 maxOutputTokens请留足,太小可能全部用于思考,正文为空、结束原因为MAX_TOKENS。gemini-4-carbon不支持thinkingBudget,会返回 400。
json
{
"contents": [{ "role": "user", "parts": [{ "text": "解释一下 TCP 三次握手" }] }],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": { "thinkingLevel": "low" }
}
}响应格式
json
{
"candidates": [
{
"content": {
"role": "model",
"parts": [{ "text": "我是一个由 Google 训练的大型语言模型……" }]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 8,
"candidatesTokenCount": 24,
"thoughtsTokenCount": 120,
"totalTokenCount": 152
}
}finishReason 为 MAX_TOKENS 时说明输出被截断,调大 maxOutputTokens。
流式响应
bash
curl "https://arcnovatech.info/v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse" \
-H "x-goog-api-key: $ARCAI_API_KEY" \
-H "content-type: application/json" \
-d '{
"contents": [{ "role": "user", "parts": [{ "text": "写一首关于秋天的短诗" }] }]
}'返回 Server-Sent Events,每个 data: 行是一个与上面结构相同的片段。一次流式请求在 Trace 里是一条记录。
认证方式
按优先级识别:x-goog-api-key 请求头、Authorization: Bearer、x-api-key、URL 参数 ?key=。推荐用请求头,避免 Key 出现在日志记录的 URL 里。
不支持的部分
- Embeddings:当前 Gemini 分组不提供向量接口。
- 官方 SDK 中与 Google 账号绑定的功能(文件上传、调优模型等)没有在 ArcAI 上验证过。
待确认
本页的 SDK 示例(Python google-genai、Node @google/genai)还没有经 ArcAI 实测。上线前请各跑一次。