StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
Guía de integración
Gemini 2.5 Flash Lite - Native API - 快速开始Gemini 2.5 Flash Lite - Native API - API Reference
StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
TextoGeminiGemini.2.5.Flash.LiteNative.API

Gemini 2.5 Flash Lite - Native API - Inicio rápido

  • Llama al modelo gemini-2.5-flash-lite usando el formato Google Native API
  • Puede usar modo de procesamiento síncrono, devuelve el contenido de la conversación en tiempo real
  • Conversación de texto plano: Diálogo contextual de uno o varios turnos, consulta los ejemplos simple_text y multi_turn en las muestras de código
  • Entrada multimodal: Compatible con entrada mixta de texto + imagen/audio/video, consulta los ejemplos audio_analysis, image_understanding y multi_file en las muestras de código
  • Ajuste de parámetros: Controla la calidad de generación mediante generationConfig
  • Streaming: Elige el modo de generación mediante el parámetro method
<Tip> **Streaming**: Reemplace `generateContent` por `streamGenerateContent` en la URL. Los parámetros del cuerpo de la solicitud son idénticos. Las respuestas se devolverán en bloques de streaming. Consulte la sección «Respuesta en streaming» a continuación para el formato de respuesta. </Tip> <Note> **BaseURL**: La BaseURL predeterminada es `https://api.starmagic.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.starmagic.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto. </Note>

Autorización

AuthorizationstringheaderObligatorio

##Todas las APIs requieren autenticación Bearer Token## **Obtener API Key:** Visita la [Página de gestión de API Key](https://starmagic.ai/app/api-keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

application/json
contentsobject[]Obligatorio

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"

Respuesta

application/json
请求错误

Cuerpo de respuesta

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"
        }
      ]
    }
  ]
}'
Respuesta: 请求错误
{
  "error": {
    "code": 400,
    "message": "Parámetros de solicitud inválidos",
    "type": "invalid_request_error"
  }
}