日本語

テキストGeminiGemini.2.5.Flash.LiteNative.API

Gemini 2.5 Flash Lite - Native API - クイックスタート

Google Native API形式でGemini-2.5-flash-liteモデルを呼び出し

同期処理モード、会話内容をリアルタイムで返却
最小限のパラメータですぐに開始可能
💡 より多くの機能が必要ですか？完全なAPIリファレンスをご確認ください

<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[]必須

会話コンテンツのリスト

[
  {
    "role": "user",
    "parts": [
      {
        "text": "Hello, introduce yourself"
      }
    ]
  }
]

レスポンス

application/json

成功

レスポンスボディ

candidatesobject[]

候補応答のリスト

[
  {
    "content": {
      "role": "model",
      "parts": [
        null
      ]
    },
    "finishReason": "STOP",
    "index": 0,
    "safetyRatings": [
      {}
    ]
  }
]

promptFeedbackobject

{
  "safetyRatings": [
    {}
  ]
}

usageMetadataobject

使用統計

{
  "promptTokenCount": 4,
  "candidatesTokenCount": 611,
  "totalTokenCount": 2422,
  "thoughtsTokenCount": 1807,
  "promptTokensDetails": [
    {
      "modality": "TEXT",
      "tokenCount": 4
    }
  ]
}

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": "Hello, introduce yourself"
        }
      ]
    }
  ]
}'

レスポンス: 成功

{
  "candidates": [
    {
      "content": {
        "role": null,
        "parts": null
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": null,
        "tokenCount": null
      }
    ]
  }
}

日本語

テキストGeminiGemini.2.5.Flash.LiteNative.API

Gemini 2.5 Flash Lite - Native API - クイックスタート

Google Native API形式でGemini-2.5-flash-liteモデルを呼び出し

同期処理モード、会話内容をリアルタイムで返却
最小限のパラメータですぐに開始可能
💡 より多くの機能が必要ですか？完全なAPIリファレンスをご確認ください

認証

Authorizationstringheader必須

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json

contentsobject[]必須

会話コンテンツのリスト

[
  {
    "role": "user",
    "parts": [
      {
        "text": "Hello, introduce yourself"
      }
    ]
  }
]

レスポンス

application/json

成功

レスポンスボディ

candidatesobject[]

候補応答のリスト

[
  {
    "content": {
      "role": "model",
      "parts": [
        null
      ]
    },
    "finishReason": "STOP",
    "index": 0,
    "safetyRatings": [
      {}
    ]
  }
]

promptFeedbackobject

{
  "safetyRatings": [
    {}
  ]
}

usageMetadataobject

使用統計

{
  "promptTokenCount": 4,
  "candidatesTokenCount": 611,
  "totalTokenCount": 2422,
  "thoughtsTokenCount": 1807,
  "promptTokensDetails": [
    {
      "modality": "TEXT",
      "tokenCount": 4
    }
  ]
}

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": "Hello, introduce yourself"
        }
      ]
    }
  ]
}'

レスポンス: 成功

{
  "candidates": [
    {
      "content": {
        "role": null,
        "parts": null
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": null,
        "tokenCount": null
      }
    ]
  }
}