Skip to content

Gemini 原生 API ​

ArcAI 兼容 Google Gemini API 的 v1beta 格式。已经在用 Gemini API 的代码,只需要改 Base URL 和 Key。

项目值
Base URLhttps://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)

请求参数 ​

参数类型必填说明
contentsarray是对话内容。每项包含 role(user / model)和 parts
systemInstructionobject否系统指令,格式 {"parts": [{"text": "..."}]}
generationConfigobject否生成参数,见下表
toolsarray否函数声明等工具。受 工具策略 约束
safetySettingsarray否安全过滤设置,每项包含 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 实测。上线前请各跑一次。

内容以控制台实际显示为准