Docs Rivya AI
Pagini API model

Integrare API Gemini 3 Pro

Folosește Gemini 3 Pro prin Rivya Public API v1 cu model id gemini-3-pro-chat, inputuri suportate, parametri, reguli Files API, credite și exemple de răspuns.

Disponibil prin APIInput text gataChat
API model id

gemini-3-pro-chat

Inputuri

text, file

Files API

Nu este necesar pentru cererea minimă

Credite de bază

2

Capabilitate

Chat

Readiness

API chat: fără streaming + streaming SSE

Billing

TOKEN_BASED

Limită prompt

20000 caractere

Contract cerere

Cererile Chat trimit câte un mesaj pe rând. Istoricul sesiunii este stocat de Rivya; nu trimite un array raw messages.

KeyTipNecesarImplicitDescriere
modelstringDagemini-3-pro-chatFolosește API model id gemini-3-pro-chat.
session_idstringNu-ID opțional de sesiune chat creată prin API. Omite-l pentru a începe o sesiune nouă.
messagestringDa-Următorul mesaj al utilizatorului. Istoricul Chat API vine din sesiunea server-side, nu dintr-un array raw messages.
attachmentsarrayNu-Valori opționale file_id pentru imagini returnate de Files API. URL-urile externe de atașamente nu sunt acceptate.
enable_web_searchbooleanNufalseSe aplică doar când modelul chat selectat suportă web search.
reasoning_effortstringNudefaultReasoning effort opțional: default, minimal, low, medium, high sau xhigh când este suportat.
client_request_idstringNu-ID client-side opțional pentru urmărirea cererilor în sistemul tău.

Parametri model

Acest model chat folosește câmpurile Chat API comune de mai sus. Suportul specific modelului pentru web search, atașamente image file, thoughts și reasoning este reflectat în datele de readiness.

Cerere minimă

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

Cerere cu fișier de referință

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

Răspuns create

Endpointul Chat returnează un mesaj assistant finalizat, token usage și settlementul final de credite pentru acest turn.

{
  "id": "chatcmpl_msg_gemini_3_pro_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gemini_3_pro_chat",
  "model": "gemini-3-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
  }
}

Erori comune

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

Chat API suportă turnuri non-streaming și SSE streaming în Public API v1. Atașamentele imagine trebuie să folosească valori file_id din Files API.