Rivya AI -dokumentaatio
Mallien API-sivut

Gemini 3 Flash API -integraatio

Käytä mallia Gemini 3 Flash Rivya Public API v1:n kautta malli-ID:llä gemini-3-flash-chat; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTekstisyöte valmisChat
API-malli-ID

gemini-3-flash-chat

Syötteet

text, file

Files API

Ei vaadita minimipyynnössä

Peruskrediitit

1

Kyvykkyys

Chat

Valmius

Chat API: ei-streamaava + SSE-streamaus

Laskutus

TOKEN_BASED

Prompt-raja

20000 merkkiä

Pyyntösopimus

Chat-pyynnöt lähettävät yhden viestin kerrallaan. Sessiohistoria tallennetaan Rivyassa; älä lähetä raw messages -taulukkoa.

AvainTyyppiPakollinenOletusKuvaus
modelstringKyllägemini-3-flash-chatKäytä gemini-3-flash-chat-arvoa API-malli-ID:nä.
session_idstringEi-Valinnainen API:n luoma chat session id. Jätä pois, jos haluat aloittaa uuden session.
messagestringKyllä-Seuraava käyttäjäviesti. Chat API -historia tulee palvelinpuolen sessiosta, ei raw messages -taulukosta.
attachmentsarrayEi-Valinnaiset kuvan file_id-arvot, jotka Files API palauttaa. Ulkoisia liite-URL:eja ei hyväksytä.
enable_web_searchbooleanEifalseKoskee vain valittua chat-mallia, jos se tukee verkkohakua.
reasoning_effortstringEidefaultValinnainen reasoning effort: default, minimal, low, medium, high tai xhigh, jos malli tukee sitä.
client_request_idstringEi-Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Tämä chat-malli käyttää yllä olevia jaettuja Chat API -kenttiä. Mallikohtainen tuki verkkohakuun, kuvatiedostoliitteisiin, thoughts-sisältöön ja reasoningiin näkyy valmiusdatassa.

Minimipyyntö

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

Referenssitiedostopyyntö

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

Create-vastaus

Chat-endpoint palauttaa valmiin assistant-viestin, token-käytön ja tämän vuoron lopullisen krediittiselvityksen.

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

Yleiset virheet

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

Chat API tukee ei-streamaavia ja SSE-streamaavia vuoroja Public API v1:ssä. Kuvien liitteiden on käytettävä Files API:n file_id-arvoja.