메인 콘텐츠로 건너뛰기
POST
BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.
명시적 컨텍스트 캐싱: 반복해서 사용하는 긴 프리픽스(긴 문서, 시스템 지침, 도구 정의)를 캐시로 생성하면 이후 생성 요청에는 캐시 이름과 새 질문만 보내면 됩니다. 캐시 토큰은 캐시 적중 단가로 과금됩니다. 별도로 캐시 쓰기 요금과 시간 단위 저장 요금이 발생하며, 저장 요금은 생성 시 전체 유효 기간분을 청구하고 환불되지 않습니다.
캐시 참조: generateContent 또는 streamGenerateContent 요청 본문에 "cachedContent": "<name>"을 추가하고 contents에는 새 질문만 넣습니다. 캐시를 참조하는 요청에는 systemInstruction, tools, toolConfig를 포함할 수 없으며, 캐시 생성 시와 같은 모델을 사용해야 합니다.

인증

Authorization
string
header
필수

모든 엔드포인트는 Bearer Token 인증이 필요합니다

API Key 발급:

API Key 관리에서 발급받으세요.

다음 요청 헤더 추가:

Gemini 네이티브 형식인 x-goog-api-key: YOUR_API_KEY 헤더 또는 ?key=YOUR_API_KEY URL 매개변수도 사용할 수 있습니다.

본문

application/json
model
string
필수

모델. models/gemini-3.8-flash와 gemini-3.8-flash 모두 허용. 지원 모델: gemini-3.8-flash, gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3-flash-preview, gemini-3.1-flash-lite-preview, gemini-3.1-pro-preview, gemini-3.1-pro-preview-customtools, gemini-3-pro-preview

예시:

"models/gemini-3.8-flash"

contents
object[]

캐시할 대화 내용. 배열이어야 하며 참조 시 대화 접두사가 됩니다. contents, systemInstruction, tools 중 하나 이상 필요

systemInstruction
object

시스템 지침. 캐시한 뒤에는 이를 참조하는 생성 요청에 systemInstruction을 넣을 수 없습니다

tools
object[]

도구 선언. 캐시한 뒤에는 이를 참조하는 생성 요청에 tools를 넣을 수 없습니다

toolConfig
object

도구 호출 설정(functionCallingConfig 등). 캐시한 뒤에는 이를 참조하는 생성 요청에 toolConfig를 넣을 수 없습니다

ttl
string

유효 기간(예: "3600s"). 최소 60s, 최대 604800s(168시간). expireTime과 상호 배타적이며 동시 지정은 400. 둘 다 생략하면 3600s

예시:

"3600s"

expireTime
string<date-time>

절대 만료 시각(RFC 3339, UTC). ttl과 상호 배타적이며 동시 지정은 400

예시:

"2026-11-03T06:00:00Z"

displayName
string

관리용 이름. 최대 255자이며 요금에 영향 없음

Maximum string length: 255
예시:

"product-manual-v3"

응답

캐시가 생성되었습니다. usageMetadata.totalTokenCount는 쓰기 및 저장 요금 계산에 사용하는 캐시 토큰 수입니다

name
string

cachedContents/<id> 형식의 이름. 생성 요청의 cachedContent에 지정하며 <id>는 생성 요청 ID이기도 합니다

예시:

"cachedContents/20261103012026348092000s1oTuB96"

model
string

캐시에 연결된 모델. 생성 요청도 같은 모델을 사용해야 함

예시:

"models/gemini-3.8-flash"

displayName
string

생성 시 지정한 이름. 지정하지 않았다면 반환하지 않음

createTime
string<date-time>

생성 시각(UTC)

updateTime
string<date-time>

마지막 수정 시각(UTC)

expireTime
string<date-time>

만료 시각(UTC). 만료 후 자동 삭제

usageMetadata
object