Formato API Nativa de Google

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

POST

v1beta

models

gemini-2.5-flash-lite:generateContent

curl --request POST \
  --url https://direct.evolink.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"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.1-pro-preview",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

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.

BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

contents

object[]

requerido

List of conversation contents, supports multi-turn dialogue and multimodal input

Minimum array length: 1

Show child attributes

generationConfig

object

Generation configuration parameters (optional)

Show child attributes

systemInstruction

object

System instruction (optional), mainly text content

Show child attributes

tools

object[]

List of tools the model can call, such as function calling or code execution

toolConfig

object

Tool calling configuration (optional)

safetySettings

object[]

Safety settings list (optional)

cachedContent

string

Cached content name, in the form cachedContents/{cachedContent}

Respuesta

Contenido generado exitosamente

Descripción del formato de respuesta:

Al usar el endpoint generateContent, devuelve GenerateContentResponse (devuelve la respuesta completa de una vez)
Al usar el endpoint streamGenerateContent, devuelve StreamGenerateContentResponse (respuesta en streaming, devuelve contenido en fragmentos)

Respuesta sincrónica
Respuesta en streaming

candidates

object[]

List of candidate responses

Show child attributes

promptFeedback

object

Show child attributes

usageMetadata

object

Estadísticas de uso

Show child attributes

modelVersion

string

Model version

Ejemplo:

"gemini-3.1-pro-preview"

responseId

string

Response ID

Ejemplo:

"l-LoaPu0BPmo1dkP6ZPHiQc"

Gemini 2.5 Flash Lite - OpenAI SDK - Referencia de la API Interfaz de chat GPT-5.5