Rivya AI-docs
Model-API-pagina's

Gemini 2.5 Pro API-integratie

Gebruik Gemini 2.5 Pro via Rivya Public API v1 met model-id gemini-2-5-pro-chat, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekstinput gereedChat
API-model-id

gemini-2-5-pro-chat

Inputs

text, file

Files API

Niet vereist voor de minimale request

Basiscredits

2

Mogelijkheid

Chat

Gereedheid

Chat API: non-streaming + SSE-streaming

Facturering

TOKEN_BASED

Promptlimiet

20000 tekens

Requestcontract

Chatrequests sturen één bericht tegelijk. Sessiegeschiedenis wordt door Rivya opgeslagen; stuur geen ruwe messages-array.

KeyTypeVereistStandaardBeschrijving
modelstringJagemini-2-5-pro-chatGebruik de API-model-id gemini-2-5-pro-chat.
session_idstringNee-Optionele door de API aangemaakte chat session id. Laat weg om een nieuwe sessie te starten.
messagestringJa-Het volgende gebruikersbericht. Chat API-geschiedenis komt uit de server-side sessie, niet uit een ruwe messages-array.
attachmentsarrayNee-Optionele image file_id-waarden die door Files API zijn teruggegeven. Externe attachment-URL's worden niet geaccepteerd.
enable_web_searchbooleanNeefalseAlleen van toepassing wanneer het geselecteerde chatmodel web search ondersteunt.
reasoning_effortstringNeedefaultOptionele reasoning effort: default, minimal, low, medium, high of xhigh wanneer ondersteund.
client_request_idstringNee-Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Dit chatmodel gebruikt de gedeelde Chat API-velden hierboven. Modelspecifieke ondersteuning voor web search, afbeeldingsbestandsbijlagen, thoughts en reasoning wordt in de gereedheidsdata weergegeven.

Minimale request

{
  "model": "gemini-2-5-pro-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Request met referentiebestand

{
  "model": "gemini-2-5-pro-chat",
  "message": "Write a concise launch plan for a new product image campaign",
  "attachments": [
    {
      "file_id": "file_uploaded_image_id"
    }
  ]
}

Create-response

Het Chat-endpoint geeft een voltooid assistentbericht, tokengebruik en de definitieve creditsettlement voor deze turn terug.

{
  "id": "chatcmpl_msg_gemini_2_5_pro_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gemini_2_5_pro_chat",
  "model": "gemini-2-5-pro-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "A concise launch plan with clear next steps."
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 2,
    "final": 2
  }
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

Chat API ondersteunt non-streaming en SSE-streaming turns in Public API v1. Afbeeldingsbijlagen moeten file_id-waarden uit Files API gebruiken.