텍스트GeminiGemini.2.5.Flash.LiteOpenai.Sdk

Gemini 2.5 Flash Lite - OpenAI SDK - 빠른 시작

OpenAI SDK 형식으로 gemini-2.5-flash-lite 모델 호출

동기 처리 모드, 대화 내용을 실시간으로 반환
최소 파라미터로 빠른 시작
💡 더 많은 기능이 필요하신가요? 전체 API 레퍼런스를 확인하세요

<Note> **BaseURL**: 기본 BaseURL은 `https://api.starmagic.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.starmagic.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. </Note>

인증

Authorizationstringheader필수

##모든 API는 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": "Hello, introduce yourself"
  }
]

응답

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": "Note: This is sample code!\n\nHello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google..."
    },
    "finish_reason": "stop"
  }
]

usageobject

토큰 사용 통계

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

응답: 成功

{
  "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
  }
}

Gemini 2.5 Flash Lite - Native API - API Reference

Gemini 2.5 Flash Lite - OpenAI SDK - API Reference

[ { "index": 0, "message": { "role": "assistant", "content": "Note: This is sample code!\n\nHello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google..." }, "finish_reason": "stop" } ]

{ "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 }

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

{ "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 } }