TokenLab

Gemini Files 및 캐시

Gemini 파일 및 캐시된 콘텐츠

Gemini 파일을 업로드하고 Workspace 소유의 파일 및 캐시된 콘텐츠를 관리합니다.

해당 작업을 지원하는 최신 TokenLab 모델에서 Gemini 파일 및 캐시된 콘텐츠를 사용하세요. 요청을 보내기 전에 모델 세부 정보에서 지원되는 메서드를 확인하십시오.

Workspace 소유권

파일 및 캐시된 콘텐츠는 인증된 요청과 연결된 Workspace에 속합니다. 동일한 Workspace를 사용하여 생성, 나열, 읽기, 참조, 업데이트 및 삭제를 수행하십시오. 리소스 이름이나 파일 URI는 소유권을 이전하지 않습니다.

파일

지원되는 소스에는 register를 사용하십시오. 로컬 바이트를 업로드하지 않습니다. 로컬 파일의 경우 해당 바이트를 업로드 엔드포인트로 전송하십시오. 파일을 나열하거나 읽고, 반환된 URI를 Gemini 콘텐츠에 사용하기 전에 파일이 준비될 때까지 기다리십시오. 파일은 등록, 읽기 및 삭제가 가능하며, 이러한 경로에서는 파일 업데이트 작업을 제공하지 않습니다.

캐시된 콘텐츠

지원되는 모델에 대해 캐시된 콘텐츠를 생성한 다음, 반환된 name을 동일한 Workspace의 이후 generateContent 요청에서 cachedContent로 사용하십시오. GET은 캐시 메타데이터를 읽고, PATCH는 수명을 업데이트하며, DELETE는 이를 제거합니다. 삭제되었거나 만료된 캐시는 생성에 사용할 수 없습니다.

재개 가능한 업로드(Resumable upload)

POST /upload/v1beta/files, X-Goog-Upload-Protocol: resumable 및 X-Goog-Upload-Command: start로 세션을 시작하십시오. 메타데이터를 전송하고 정확한 X-Goog-Upload-URL 응답 헤더를 읽으십시오. 업로드 명령 및 확인된 오프셋과 함께 각 바이트 청크를 해당 URL로 POST하십시오.

이 URL은 비공개 기능으로, 지속을 승인하며 1시간 후에 만료됩니다. 비밀로 유지하고 게시, 로그 기록 또는 공유하지 마십시오. 일반적인 HTTP 리디렉션으로 따라가지 마십시오. 308은 청크가 수락되었지만 업로드가 아직 완료되지 않았음을 의미하므로 동일한 URL에서 계속하십시오. 404는 세션이 없거나 만료되었음을 의미합니다. 410은 더 이상 계속할 수 없음을 의미하므로 새 세션을 시작하십시오. 최종 성공 응답에 파일 리소스가 포함된 경우에만 업로드가 완료된 것으로 간주하십시오.

SDK 설정

프로세스 환경에서 TOKENLAB_API_KEY를 설정하십시오. TokenLab 호스트 및 v1beta API 버전으로 Google Gen AI SDK를 구성하십시오:

import os
from google import genai

client = genai.Client(
    api_key=os.environ["TOKENLAB_API_KEY"],
    http_options={"base_url": "https://api.tokenlab.sh", "api_version": "v1beta"},
)
import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  httpOptions: { baseUrl: "https://api.tokenlab.sh", apiVersion: "v1beta" },
});

키와 업로드 URL을 소스 제어, 브라우저 저장소 및 로그에 남기지 마십시오.

작업

메서드경로작업
POST/v1beta/files:register지원되는 소스 등록
POST/v1beta/files파일 메타데이터 생성
GET/v1beta/files파일 나열
GET/v1beta/files/{fileId}파일 메타데이터 읽기
DELETE/v1beta/files/{fileId}파일 삭제
POST/v1beta/cachedContents캐시된 콘텐츠 생성
GET/v1beta/cachedContents캐시된 콘텐츠 나열
GET/v1beta/cachedContents/{cacheId}캐시된 콘텐츠 읽기
PATCH/v1beta/cachedContents/{cacheId}캐시 수명 업데이트
DELETE/v1beta/cachedContents/{cacheId}캐시된 콘텐츠 삭제
POST/upload/v1beta/files바이트 업로드 또는 세션 시작
POST/upload/v1beta/files/session/{sessionId}재개 가능한 업로드 계속

목록 엔드포인트는 pageSize 및 pageToken을 지원합니다. 반환된 캐시된 콘텐츠 이름을 이후 Gemini 요청에서 cachedContent로 사용하십시오. 모든 필드에 대해서는 OpenAPI 사양 및 콘텐츠 생성을 참조하십시오.

이 페이지의 내용