메인 콘텐츠로 건너뛰기
PATCH
BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.
유효 기간만 변경할 수 있으며, 요청 본문에 ttl 또는 expireTime 중 하나를 보냅니다. 연장 시 추가 기간분 저장 요금을 청구하며, 단축해도 환불되지 않습니다.

인증

Authorization
string
header
필수

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

API Key 발급:

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

다음 요청 헤더 추가:

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

경로 매개변수

id
string
필수

캐시 ID: 생성 시 반환된 name에서 cachedContents/를 뺀 부분입니다. cachedContents/20261103012026348092000s1oTuB96이면 20261103012026348092000s1oTuB96을 지정합니다.

예시:

"20261103012026348092000s1oTuB96"

본문

application/json

ttl 또는 expireTime 중 정확히 하나 필수. 다른 필드는 400

ttl
string

지금부터의 새 유효 기간(예: "7200s"). 최소 60s, 최대 604800s

예시:

"7200s"

expireTime
string<date-time>

새 절대 만료 시각(RFC 3339, UTC)

예시:

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

응답

갱신된 캐시 메타데이터. expireTime은 새 만료 시각입니다

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