StarMagicStarMagic
简体中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
集成向导
Gemini 2.5 Flash Lite - OpenAI SDK - 快速开始Gemini 2.5 Flash Lite - OpenAI SDK - API Reference
StarMagicStarMagic
简体中文
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
文本系列GeminiGemini.2.5.Flash.LiteOpenai.Sdk

Gemini 2.5 Flash Lite - OpenAI SDK - 快速开始

  • 使用 OpenAI SDK 格式调用 Gemini-2.5-flash-lite 模型
  • 同步处理模式,实时返回对话内容
  • 最简化参数,快速上手 <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
modelenum<gemini-2.5-flash-lite>必填

对话模型名称

"gemini-2.5-flash-lite"
messagesobject[]必填

对话消息列表

[
  {
    "role": "user",
    "content": "你好,介绍一下自己"
  }
]

响应

application/json
成功

响应体

idstring

对话完成的唯一标识符

"chatcmpl-20251010015944503180122WJNB8Eid"
modelstring

实际使用的模型名称

"gemini-2.5-flash-lite"
objectenum<chat.completion>

响应类型

"chat.completion"
createdinteger

创建时间戳

1760032810
choicesobject[]

对话生成的选择列表

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "请注意此为示例代码!\n\n你好!很高兴能向你介绍自己。\n\n我是一个大型语言模型(Large Language Model),由 Google 训练和开发..."
    },
    "finish_reason": "stop"
  }
]
usageobject

Token 使用统计信息

{
  "prompt_tokens": 13,
  "completion_tokens": 1891,
  "total_tokens": 1904,
  "prompt_tokens_details": {
    "cached_tokens": 0,
    "text_tokens": 13,
    "audio_tokens": 0,
    "image_tokens": 0
  },
  "completion_tokens_details": {
    "text_tokens": 0,
    "audio_tokens": 0,
    "reasoning_tokens": 1480
  },
  "input_tokens": 0,
  "output_tokens": 0,
  "input_tokens_details": null
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-2.5-flash-lite",
  "messages": [
    {
      "role": "user",
      "content": "你好,介绍一下自己"
    }
  ]
}'
响应: 成功
{
  "id": "chatcmpl-20251010015944503180122WJNB8Eid",
  "model": "gemini-2.5-flash-lite",
  "object": "chat.completion",
  "created": 1760032810,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 1891,
    "total_tokens": 1904,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 13,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 1480
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null
  }
}