Έγγραφα Rivya AI
Σελίδες API μοντέλων

Gemini 2.5 Flash API integration

Χρησιμοποιήστε το Gemini 2.5 Flash μέσω Rivya Public API v1 με model id gemini-2-5-flash-chat, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText input έτοιμοΣυνομιλία
ID μοντέλου API

gemini-2-5-flash-chat

Inputs

text, file

Files API

Δεν απαιτείται για το minimal request

Βασικές πιστώσεις

1

Δυνατότητα

Συνομιλία

Ετοιμότητα

Chat API: χωρίς streaming + SSE streaming

Χρέωση

TOKEN_BASED

Όριο prompt

20000 χαρακτήρες

Σύμβαση αιτήματος

Τα Chat requests στέλνουν ένα message κάθε φορά. Το session history αποθηκεύεται από το Rivya. Μην στέλνετε raw messages array.

KeyΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιgemini-2-5-flash-chatΧρησιμοποιήστε το gemini-2-5-flash-chat ως API model id.
session_idstringΌχι-Προαιρετικό chat session id που δημιουργείται από το API. Παραλείψτε το για να ξεκινήσει νέο session.
messagestringΝαι-Το επόμενο μήνυμα χρήστη. Το history του Chat API προέρχεται από server-side session, όχι από raw messages array.
attachmentsarrayΌχι-Προαιρετικές τιμές image file_id που επιστρέφει το Files API. Εξωτερικά attachment URLs δεν γίνονται δεκτά.
enable_web_searchbooleanΌχιfalseΙσχύει μόνο όταν το επιλεγμένο chat model υποστηρίζει web search.
reasoning_effortstringΌχιdefaultΠροαιρετικό reasoning effort: default, minimal, low, medium, high ή xhigh όταν υποστηρίζεται.
client_request_idstringΌχι-Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

Παράμετροι μοντέλου

Αυτό το chat model χρησιμοποιεί τα κοινά Chat API fields παραπάνω. Η model-specific υποστήριξη για web search, image file attachments, thoughts και reasoning αποτυπώνεται στα readiness data.

Ελάχιστο αίτημα

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

Αίτημα με αρχείο αναφοράς

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

Απόκριση δημιουργίας

Το Chat endpoint επιστρέφει completed assistant message, token usage και το final credit settlement για αυτό το turn.

{
  "id": "chatcmpl_msg_gemini_2_5_flash_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gemini_2_5_flash_chat",
  "model": "gemini-2-5-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
  }
}

Συνηθισμένα σφάλματα

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

Το Chat API υποστηρίζει non-streaming και SSE streaming turns στο Public API v1. Τα image attachments πρέπει να χρησιμοποιούν τιμές file_id από το Files API.