한국어

텍스트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 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": [
      {
        "text": "Hello, introduce yourself"
      }
    ]
  }
]

응답

application/json

成功

응답 본문

candidatesobject[]

마지막 프레임 이미지 URL **참고:** - `image_start` (첫 프레임 이미지 URL)와 `image_end` (마지막 프레임 이미지 URL) 중 하나 이상 필요 - 마지막 프레임은 첫 프레임이 필요합니다 - 이미지 요구사항은 `image_start`와 동일합니다

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

Doubao Seed 2.0 Responses API - 完整参数文档

Gemini 2.5 Flash Lite - Native API - API Reference

한국어

텍스트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
      }
    ]
  }
}

Doubao Seed 2.0 Responses API - 完整参数文档

Gemini 2.5 Flash Lite - Native API - API Reference