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 - APIリファレンス

  • Google Native 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必須

##すべてのAPIにBearer Token認証が必要です## **APIキーの取得：** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json
contentsobject[]必須

List of conversation contents, supports multi-turn dialogue and multimodal input

[
  {
    "role": "user",
    "parts": [
      null
    ]
  }
]
generationConfigobject

Generation configuration parameters

{
  "temperature": 0.7,
  "maxOutputTokens": 2000,
  "topP": 0.9,
  "topK": 40,
  "candidateCount": 1,
  "responseMimeType": "application/json",
  "responseSchema": {},
  "responseJsonSchema": {},
  "thinkingConfig": {}
}
systemInstructionobject
{
  "role": "user",
  "parts": [
    null
  ]
}
toolsobject[]

List of tools the model can call, such as function calling or code execution

[
  {}
]
toolConfigobject

Tool calling configuration (optional)

{}
safetySettingsobject[]

Safety settings list (optional)

[
  {}
]
cachedContentstring

Cached content name, in the form 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": "Please introduce yourself"
        }
      ]
    }
  ]
}'
レスポンス: 请求错误
{
  "error": {
    "code": 400,
    "message": "無効なリクエストパラメータ",
    "type": "invalid_request_error"
  }
}