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

Gemini 3.0 Flash - OpenAI SDK - Referencia completa

  • Usar el formato de la API nativa de Google para llamar al modelo gemini-3.0-flash
  • Modo de procesamiento síncrono, respuesta en tiempo real
  • Parámetros mínimos para inicio rápido
  • 💡 ¿Necesitas más funciones? Consulta la Referencia completa de la API
<Tip> **Streaming**: Reemplace `generateContent` por `streamGenerateContent` en la URL para habilitar respuestas en streaming y recibir contenido en tiempo real por bloques. </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

Lista de contenido de conversación

[
  {
    "role": "user",
    "parts": [
      {
        "text": "Hello, please introduce yourself"
      }
    ]
  }
]

Respuesta

application/json
成功

Cuerpo de respuesta

candidatesobject[]

Lista de respuestas candidatas

[
  {
    "content": {
      "role": "model",
      "parts": [
        null
      ]
    },
    "finishReason": "STOP",
    "index": 0,
    "safetyRatings": [
      {}
    ]
  }
]
promptFeedbackobject
{
  "safetyRatings": [
    {}
  ]
}
usageMetadataobject

Estadísticas de uso

{
  "promptTokenCount": 4,
  "candidatesTokenCount": 611,
  "totalTokenCount": 2422,
  "thoughtsTokenCount": 1807,
  "promptTokensDetails": [
    {
      "modality": "TEXT",
      "tokenCount": 4
    }
  ]
}
POST/v1beta/models/gemini-3-flash-preview:generateContent
curl --request POST \
  --url https://api.starmagic.ai/v1beta/models/gemini-3-flash-preview:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello, please introduce yourself"
        }
      ]
    }
  ]
}'
Respuesta: 成功
{
  "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
      }
    ]
  }
}