Docs Rivya AI
Halaman API model

Integrasi API Gemini 3 Flash

Gunakan Gemini 3 Flash melalui Rivya Public API v1 dengan ID model gemini-3-flash-chat, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIInput teks sediaSembang
ID model API

gemini-3-flash-chat

Input

text, file

Files API

Tidak diperlukan untuk permintaan minimum

Kredit asas

1

Keupayaan

Sembang

Kesediaan

Chat API: bukan streaming + streaming SSE

Bil

TOKEN_BASED

Had prompt

20000 aksara

Kontrak permintaan

Permintaan Chat menghantar satu mesej pada satu masa. Sejarah sesi disimpan oleh Rivya; jangan hantar array messages mentah.

KunciJenisWajibLalaiPenerangan
modelstringYagemini-3-flash-chatGunakan ID model API gemini-3-flash-chat.
session_idstringTidak-ID sesi chat ciptaan API pilihan. Abaikan untuk memulakan sesi baharu.
messagestringYa-Mesej pengguna seterusnya. Sejarah Chat API datang daripada sesi sisi server, bukan array messages mentah.
attachmentsarrayTidak-Nilai file_id imej pilihan yang dikembalikan oleh Files API. URL lampiran luaran tidak diterima.
enable_web_searchbooleanTidakfalseHanya digunakan apabila model chat yang dipilih menyokong carian web.
reasoning_effortstringTidakdefaultUsaha penaakulan pilihan: default, minimal, low, medium, high atau xhigh apabila disokong.
client_request_idstringTidak-ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Model chat ini menggunakan medan Chat API kongsi di atas. Sokongan khusus model untuk carian web, lampiran fail imej, thoughts dan reasoning ditunjukkan dalam data kesediaan.

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint Chat mengembalikan mesej assistant lengkap, penggunaan token dan penyelesaian kredit akhir untuk giliran ini.

{
  "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
  }
}

Ralat biasa

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

Chat API menyokong giliran bukan streaming dan streaming SSE dalam Public API v1. Lampiran imej mesti menggunakan nilai file_id Files API.