Použijte Gemini 3.1 Pro přes Rivya Public API v1 s model id gemini-3-1-pro-chat, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.

Dostupné přes APITextový vstup připravenChat

ID API modelu

gemini-3-1-pro-chat

Vstupy

text, file

Files API

Není vyžadováno pro minimální požadavek

Základní kredity

Schopnost

Chat

Připravenost

Chat API: bez streamování + SSE streamování

Fakturace

TOKEN_BASED

Limit promptu

20000 znaků

Kontrakt požadavku

Chat požadavky posílají vždy jednu zprávu. Historii session ukládá Rivya; neposílejte raw messages array.

Klíč	Typ	Povinné	Výchozí	Popis
model	string	Ano	gemini-3-1-pro-chat	Použijte API model id gemini-3-1-pro-chat.
session_id	string	Ne	-	Volitelné API-created chat session id. Vynechte ho, pokud chcete začít novou session.
message	string	Ano	-	Další zpráva uživatele. Historie Chat API pochází ze server-side session, ne z raw messages pole.
attachments	array	Ne	-	Volitelné image file_id hodnoty vrácené Files API. Externí URL příloh nejsou přijímány.
enable_web_search	boolean	Ne	false	Platí jen tehdy, když vybraný chat model podporuje web search.
reasoning_effort	string	Ne	default	Volitelná reasoning effort: default, minimal, low, medium, high nebo xhigh, pokud je podporována.
client_request_id	string	Ne	-	Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

Tento chat model používá sdílená Chat API pole výše. Model-specific podpora web search, image file attachments, thoughts a reasoning se odráží v readiness datech.

Minimální požadavek

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

Požadavek s referenčním souborem

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

Odpověď vytvoření

Chat endpoint vrátí dokončenou zprávu asistenta, token usage a finální kreditní vypořádání pro tento turn.

{
  "id": "chatcmpl_msg_gemini_3_1_pro_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gemini_3_1_pro_chat",
  "model": "gemini-3-1-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": 3,
    "final": 3
  }
}

Běžné chyby

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

Chat API podporuje non-streaming a SSE streaming turns v Public API v1. Obrazové přílohy musí používat file_id hodnoty z Files API.

API integrace Gemini 3.1 Pro