> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dgrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Formato nativo de Gemini

> Gemini-native generateContent interface for text chat, multimodal media recognition (images, audio, video), speech synthesis, and image generation with structured parts. Use `generationConfig` to request specific response modalities such as speech (`speechConfig`) or images (`imageConfig`).

Esta página usa la misma operación `generateContent` que [Generar contenido (Gemini)](/es/api-reference/chat/generate-content), con el playground de arriba rellenado previamente para chat de texto plano. Las notas a continuación describen los campos nativos de Gemini que puede agregar a `generationConfig` para solicitar comprensión o generación de audio con parts estructuradas.

<Note>
  Establezca `generationConfig.responseModalities` en `["AUDIO"]` para solicitar salida de audio y configure `generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceName` para elegir una voz predefinida para el habla generada.
</Note>

### Campos de solicitud nativos de Gemini

| Campo                                                                     | Tipo   | Obligatorio | Descripción                                                    |
| ------------------------------------------------------------------------- | ------ | ----------- | -------------------------------------------------------------- |
| `generationConfig.responseModalities`                                     | array  | Sí          | Modalidades de respuesta solicitadas, por ejemplo `["AUDIO"]`. |
| `generationConfig.speechConfig`                                           | object | No          | Objeto de configuración de voz.                                |
| `generationConfig.speechConfig.voiceConfig`                               | object | No          | Contenedor de configuración de voz.                            |
| `generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig`           | object | No          | Configuración de voz predefinida.                              |
| `generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceName` | string | No          | Nombre del ajuste predefinido de voz, por ejemplo `Kore`.      |

<Tip>
  Use un modelo con capacidad de texto a voz, como `gemini-2.5-flash-preview-tts`, en el parámetro de ruta `model` cuando solicite salida de audio.
</Tip>

### Ejemplo: solicitar audio de voz

```json theme={null}
{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Say cheerfully: Have a wonderful day!" }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["AUDIO"],
    "speechConfig": {
      "voiceConfig": {
        "prebuiltVoiceConfig": {
          "voiceName": "Kore"
        }
      }
    }
  }
}
```

### Campos de respuesta

La respuesta sigue la forma estándar de `generateContent`. Cuando se solicita salida de audio, las `parts` devueltas contienen datos de audio inline en lugar de texto:

<ResponseField name="candidates" type="array">
  Respuestas candidatas devueltas por el modelo.

  <Expandable title="candidate properties">
    <ResponseField name="content" type="object">
      Objeto de contenido generado.

      <Expandable title="content properties">
        <ResponseField name="role" type="string">
          Rol devuelto en el bloque de contenido generado, normalmente `model`.
        </ResponseField>

        <ResponseField name="parts" type="array">
          Parts devueltas. Para salida de audio, cada part contiene un objeto `inlineData` con `mimeType` (por ejemplo `audio/L16;codec=pcm;rate=24000`) y `data` codificados en base64.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="finishReason" type="string">
      Cadena de motivo de finalización, por ejemplo `STOP`.
    </ResponseField>

    <ResponseField name="safetyRatings" type="array">
      Resultados de evaluación de seguridad.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="usageMetadata" type="object">
  Contabilidad de tokens, incluido `promptTokenCount`, `candidatesTokenCount` y `totalTokenCount`.
</ResponseField>

<ResponseField name="promptFeedback" type="object">
  Información de bloqueo del prompt cuando corresponda.
</ResponseField>

### Ejemplo de respuesta

```json 200 theme={null}
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "audio/L16;codec=pcm;rate=24000",
              "data": "<base64-encoded-audio-bytes>"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 0,
    "totalTokenCount": 10
  }
}
```


## OpenAPI

````yaml api-reference/openapi.json POST /v1/models/{model}:generateContent
openapi: 3.1.0
info:
  title: DGrid AI Gateway API
  description: >-
    A single, unified API to access 200+ leading AI models. OpenAI-, Claude-,
    and Gemini-compatible endpoints for chat, completions, embeddings, images,
    audio, and moderations.
  version: 1.0.0
  contact:
    name: DGrid AI
    url: https://dgrid.ai
servers:
  - url: https://api.dgrid.ai
    description: DGrid AI Gateway
security:
  - bearerAuth: []
paths:
  /v1/models/{model}:generateContent:
    post:
      tags:
        - Chat
      summary: Generate content (Gemini)
      description: >-
        Gemini-native generateContent interface for text chat, multimodal media
        recognition (images, audio, video), speech synthesis, and image
        generation with structured parts. Use `generationConfig` to request
        specific response modalities such as speech (`speechConfig`) or images
        (`imageConfig`).
      operationId: generateContent
      parameters:
        - name: model
          in: path
          required: true
          schema:
            type: string
          description: Target model ID, such as `gemini-1.5-pro`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                contents:
                  type: array
                  description: Input content array with role and parts.
                  items:
                    type: object
                    properties:
                      role:
                        type: string
                        description: Content role.
                      parts:
                        type: array
                        description: Content parts (text, inline data, media).
                        items:
                          type: object
                generationConfig:
                  type: object
                  description: Generation configuration.
                  properties:
                    responseModalities:
                      type: array
                      items:
                        type: string
                      description: >-
                        Requested response modalities, such as `TEXT`, `AUDIO`,
                        or `IMAGE`.
                    speechConfig:
                      type: object
                      description: Speech configuration for audio output.
                      properties:
                        voiceConfig:
                          type: object
                          properties:
                            prebuiltVoiceConfig:
                              type: object
                              properties:
                                voiceName:
                                  type: string
                                  description: Voice preset name.
                    imageConfig:
                      type: object
                      description: Image configuration for image output.
                      properties:
                        aspectRatio:
                          type: string
                          description: Aspect ratio.
                        imageSize:
                          type: string
                          description: Image size.
            example:
              contents:
                - role: user
                  parts:
                    - text: Hello from DGrid.
      responses:
        '200':
          description: Generated content candidates.
          content:
            application/json:
              schema:
                type: object
                properties:
                  candidates:
                    type: array
                    description: Candidate responses returned by the model.
                    items:
                      type: object
                      properties:
                        content:
                          type: object
                          description: Generated content object.
                          properties:
                            role:
                              type: string
                              description: Role in the generated content block.
                            parts:
                              type: array
                              description: Returned content parts.
                              items:
                                type: object
                        finishReason:
                          type: string
                          description: Finish reason string.
                        safetyRatings:
                          type: array
                          description: Safety evaluation results.
                          items:
                            type: object
                  usageMetadata:
                    type: object
                    description: Token accounting metadata.
                    properties:
                      promptTokenCount:
                        type: integer
                      candidatesTokenCount:
                        type: integer
                      totalTokenCount:
                        type: integer
        '400':
          $ref: '#/components/responses/BadRequest'
components:
  responses:
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            param:
              type: string
            code:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your DGrid API key. All endpoints use `Authorization: Bearer
        <DGRID_API_KEY>`.

````