StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
整合指南
Gemini 2.5 Flash Lite - Native API - 快速开始Gemini 2.5 Flash Lite - Native API - API Reference
StarMagicStarMagic
繁體中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列GeminiGemini.2.5.Flash.LiteNative.API

Gemini 2.5 Flash Lite - Native API - 完整参数文档

  • 使用 Google 原生 API 格式调用 gemini-2.5-flash-lite 模型
  • 可使用同步处理模式,实时返回对话内容
  • 纯文本对话:单轮或多轮上下文对话,可参考示例代码中 simple_text、multi_turn 示例
  • 多模态输入:支持文本 + 图像/音频/视频混合输入,可参考示例代码中 audio_analysis、image_understanding、multi_file 示例
  • 参数调优:通过 generationConfig 控制生成效果
  • 流式:将 URL 中 generateContent 替换为 streamGenerateContent 即可
<Tip> **流式调用**:将 URL 中的 `generateContent` 替换为 `streamGenerateContent`,请求体参数完全相同,响应将以流式逐块返回。响应格式参见下方「流式响应」说明。 </Tip> <Note> **BaseURL 说明**:默认 BaseURL 为 `https://api.starmagic.ai`,对文本模型支持更好,支持长连接;`https://api.starmagic.ai` 是多模态主力地址,对文本模型作为备用地址使用。 </Note>

授權

Authorizationstringheader必填

##所有接口均需要使用Bearer Token进行认证## **获取 API Key:** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

請求體

application/json
contentsobject[]必填

对话内容列表,支持多轮对话和多模态输入

[
  {
    "role": "user",
    "parts": [
      null
    ]
  }
]
systemInstructionobject
{
  "role": "user",
  "parts": [
    null
  ]
}
toolsobject[]

模型可调用的工具列表,如函数调用或代码执行

[
  {}
]
toolConfigobject

工具调用配置(可选)

{}
safetySettingsobject[]

安全设置列表(可选)

[
  {}
]
generationConfigobject

生成配置参数

{
  "temperature": 0.7,
  "maxOutputTokens": 2000,
  "topP": 0.9,
  "topK": 40,
  "responseMimeType": "application/json",
  "responseSchema": {},
  "responseJsonSchema": {},
  "candidateCount": 1,
  "thinkingConfig": {}
}
cachedContentstring

缓存内容名称,格式为 cachedContents/{cachedContent}

"string"

回應

application/json
请求错误

回應體

errorobject
{
  "code": 0,
  "message": "string",
  "type": "string",
  "fallback_suggestion": "string"
}
POST/v1beta/models/gemini-2.5-flash-lite:generateContent
curl --request POST \
  --url https://api.starmagic.ai/v1beta/models/gemini-2.5-flash-lite:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请介绍下你自己"
        }
      ]
    }
  ]
}'
回應: 请求错误
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}