Rivya Public API v1에서 Gemini 3 Flash을 모델 ID gemini-3-flash-chat, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.

API로 사용 가능텍스트 입력 준비됨채팅

API 모델 ID

gemini-3-flash-chat

입력

text, file

Files API

최소 요청에는 필요 없음

기본 크레딧

기능

채팅

준비 상태

Chat API: 비스트리밍 + SSE 스트리밍

과금

TOKEN_BASED

프롬프트 제한

20000 자

요청 계약

Chat 요청은 한 번에 하나의 메시지를 보냅니다. 세션 기록은 Rivya가 저장하므로 원시 messages 배열을 보내지 마세요.

Key	유형	필수	기본값	설명
model	string	예	gemini-3-flash-chat	gemini-3-flash-chat을 API 모델 ID로 사용합니다.
session_id	string	아니요	-	API가 생성한 채팅 세션 ID입니다. 새 세션을 시작하려면 생략하세요.
message	string	예	-	다음 사용자 메시지입니다. Chat API 기록은 원시 messages 배열이 아니라 서버 측 세션에서 가져옵니다.
attachments	array	아니요	-	Files API가 반환한 선택적 이미지 file_id 값입니다. 외부 첨부 URL은 허용되지 않습니다.
enable_web_search	boolean	아니요	false	선택한 Chat 모델이 웹 검색을 지원할 때만 적용됩니다.
reasoning_effort	string	아니요	default	선택적 reasoning effort입니다: 지원되는 경우 default, minimal, low, medium, high 또는 xhigh.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

이 Chat 모델은 위의 공통 Chat API 필드를 사용합니다. 웹 검색, 이미지 파일 첨부, thoughts, reasoning에 대한 모델별 지원은 준비 상태 데이터에 표시됩니다.

최소 요청

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

참조 파일 요청

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

생성 응답

Chat 엔드포인트는 완료된 어시스턴트 메시지, 토큰 사용량, 이 턴의 최종 크레딧 정산을 반환합니다.

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

일반 오류

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

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

Gemini 3 Flash API 연동