Guia de uso do cache de contexto do Gemini

export API_KEY="SUA_CHAVE_DE_API"

{
  "type": "text",
  "text": "Este é o último trecho de conteúdo do prefixo estável",
  "cache_control": {
    "type": "ephemeral",
    "ttl": "5m"
  }
}

system
→ Texto longo estável ou mensagens de histórico
→ Limite do prefixo estável com cache_control
→ Pergunta atual do usuário (não armazenada em cache)

curl "https://api.apimart.ai/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.6-flash",
    "stream": false,
    "messages": [
      {
        "role": "system",
        "content": "Responda estritamente de acordo com o material de referência fornecido."
      },
      {
        "role": "user",
        "content": "Insira aqui o material de referência extenso que será reutilizado…"
      },
      {
        "role": "assistant",
        "content": [
          {
            "type": "text",
            "text": "Li e compreendi o material de referência acima.",
            "cache_control": {
              "type": "ephemeral",
              "ttl": "5m"
            }
          }
        ]
      },
      {
        "role": "user",
        "content": "Resuma os três principais pontos do material de referência."
      }
    ]
  }'

curl "https://api.apimart.ai/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {
      "parts": [
        {
          "text": "Responda estritamente de acordo com o material de referência fornecido."
        }
      ]
    },
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Insira aqui o material de referência extenso que será reutilizado…"
          }
        ]
      },
      {
        "role": "model",
        "parts": [
          {
            "text": "Li e compreendi o material de referência acima.",
            "cache_control": {
              "type": "ephemeral",
              "ttl": "5m"
            }
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "text": "Resuma os três principais pontos do material de referência."
          }
        ]
      }
    ]
  }'

curl