API de Gemini 3.7 Flash: agentes de código, 1M

google/gemini-3.7-flash/chat

Gemini 3.7 Flash es el modelo de chat rápido de Google para programación diaria, herramientas agénticas y tareas de varios pasos, con una API compatible con OpenAI. Lee hasta 1.048.576 tokens y responde hasta 65.536, con tres niveles de razonamiento.

Entrada $0.675Salida $3.375por 1 millón de tokensEntrada en caché $0.0675Precio oficial de Google~~$0.75$3.75~~

Ejecutar modelo Ver API

Enviar una solicitud

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones

POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/gemini-3.7-flash/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Conserva un Idempotency-Key por cada solicitud lógica. Tras una interrupción de red, no reenvíes automáticamente con una clave nueva; guarda el request_id para investigar la solicitud aceptada. La idempotencia no vuelve a reproducir un flujo de chat anterior.

Parámetros de entrada

Los parámetros del modelo se incluyen junto a model en el cuerpo JSON. Este endpoint no utiliza un contenedor input.

messagesarray<object>Obligatorio

Turnos ordenados, del más antiguo al más reciente. El contenido es una cadena o un arreglo de partes text, image_url y video_url. El video se envía como archivo subido, y el video de una solicitud puede sumar 14 MB en total. Las reglas de la tarea y el contrato de herramientas en el mensaje de sistema, y luego un turno añadido cada vez.

Valor predeterminado: Sin especificar
Restricciones: minItems:1

messages[].rolestringObligatorio dentro del objeto

Role of the message author.

Valor predeterminado: Sin especificar
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor predeterminado: Sin especificar

messages[].contentstring | array | nullOpcional

Message content, either plain text or a list of content parts.

Valor predeterminado: Sin especificar

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor predeterminado: Sin especificar

messages[].tool_call_idstringOpcional

Identifier of the tool call this message answers. Required on tool messages.

Valor predeterminado: Sin especificar

messages[].reasoning_contentstringOpcional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valor predeterminado: Sin especificar

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text content only on this endpoint."
}

response_formatobjectOpcional

Pide un objeto JSON y nombra cada clave en el mensaje de sistema: así vuelven analizables los resultados de extracción.

Valor predeterminado: Sin especificar

tool_choicestring | objectOpcional

auto, none, required, o un objeto que nombre una función.

Valor predeterminado: Sin especificar

toolsarray<object>Opcional

Hasta 128 definiciones de función por solicitud.

Valor predeterminado: Sin especificar
Restricciones: maxItems:128

top_pnumberOpcional

De 0,01 a 1. Ajusta este o temperature, nunca los dos en la misma comparación.

Valor predeterminado: 1
Restricciones: minimum:0.01
maximum:1

temperaturenumberOpcional

De 0 a 2, 1 por defecto. Google recomienda dejar los modelos Gemini 3 en 1,0: por debajo, la generación puede entrar en bucle o degradarse. Da forma a la salida estructurada con response_format y el mensaje system.

Valor predeterminado: 1
Restricciones: minimum:0
maximum:2

seedintegerOpcional

Cualquier entero. La misma semilla con una solicitud por lo demás idéntica hace que las respuestas se repitan de cerca, así puedes cambiar una sola cosa a la vez y comparar con justicia; no garantiza una salida idéntica. Sin valor por defecto: cada solicitud sortea de nuevo. No afecta el costo.

Valor predeterminado: Sin especificar

stopstring | arrayOpcional

Hasta 4 secuencias, como cadena o como arreglo. La respuesta termina en cuanto el modelo escribe una de ellas, y el texto que coincide no se devuelve. Sin valor por defecto. No cambia la tarifa: una respuesta cortada antes se cobra solo por los tokens que produjo.

Valor predeterminado: Sin especificar
Restricciones: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

minimal, low, medium o high; medium es el valor por defecto. Los pasos rutinarios van bien en low, y el paso que tiene que acertar se sube a high por separado.

Valor predeterminado: "medium"
Valores permitidos: "minimal""low""medium""high"

max_tokensintegerOpcional

Limita la respuesta a 65.536; el valor por defecto es 16 384. Los tokens de pensamiento salen de este mismo presupuesto, así que un tope muy bajo puede gastarse antes de que empiece la respuesta y devolver una cadena vacía. Deja margen de verdad, o baja reasoning_effort cuando la respuesta deba ser corta.

Valor predeterminado: 16384
Restricciones: minimum:1
maximum:65536

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text content only on this endpoint."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 16384,
      "maximum": 65536,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply. Thinking tokens are drawn from this same budget."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "minimal",
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model works through the task before answering."
    }
  },
  "x-image-token-limit": 2000,
  "x-input-token-limit": 1048576,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Leer el resultado

Con stream en false, la solicitud devuelve directamente la respuesta completa: lee choices[].message, sin consultar ninguna tarea. Pon stream en true si tu cliente admite Server-Sent Events.

Ejemplo de respuesta completada

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-3.7-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta respuesta solo ilustra la estructura. usage trae el número de tokens; el consumo y el costo reales dependen de tu solicitud.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal y scripts de automatización.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrucciones reutilizables para tu asistente de IA.

n8n

Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.

ComfyUI

Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar flujos listos para usar

Es un modelo de chat, así que funciona donde se use la API de chat de OpenAI: mantén tu cliente, cambia la URL base y elige este modelo por su ID.

Conecta aquí cualquier cliente compatible con OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/google/gemini-3.7-flash/chat

Todo lo que use la API de chat de OpenAI funciona de la misma manera: SDKs, Vercel AI SDK, LangChain, aider, Cline. El servidor MCP y la CLI spicyapi cubren tareas de medios asíncronas. Encontrarás la configuración de cada herramienta en el centro de desarrolladores.

Úsalo en SillyTavern y apps de roleplay

En SillyTavern, RisuAI, Agnai o cualquier app con una opción compatible con OpenAI, pega la URL base de abajo y tu clave de API, y elige google/gemini-3.7-flash/chat como modelo. Se aceptan llamadas desde el navegador, y los controles que este modelo no admite se ignoran en lugar de rechazarse.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-3.7-flash/chat

Guía de SillyTavern RisuAI, Agnai y más Extensión de SillyTavern

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y elige google/gemini-3.7-flash/chat en el nodo SpicyAPI Chat para usar este modelo dentro de un grafo de ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Ejemplos de workflows Guía de configuración Código en GitHub

El panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.

<iframe src="https://spicyapi.ai/embed/es/models/gemini-3-7-flash/api?model=google%2Fgemini-3.7-flash%2Fchat" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir el panel

Playground

Enviar una solicitud

Autenticación de API

Parámetros de entrada

Leer el resultado

SDK e integraciones

Úsalo en SillyTavern y apps de roleplay

Úsalo en ComfyUI