Communitygithub.com

google-gemini/gemini-api-dev

Gemini API 호스팅 모델(Gemini, Gemma 4 포함)로 애플리케이션을 구축하고, 멀티모달 콘텐츠(텍스트, 이미지, 오디오, 비디오)를 처리하며, 함수 호출을 구현하고, 구조화된 출력을 사용하거나 최신 모델 사양이 필요할 때 사용합니다. SDK 사용법(Python용 google-genai, JavaScript/TypeScript용 @google/genai, Java용 com.google.genai:google-genai, Go용 google.golang.org/genai), 모델 선택, API 기능을 다룹니다.

gemini-api-dev란 무엇인가요?

이 스킬은 Google Gemini API를 사용하여 애플리케이션을 개발하는 개발자를 위한 종합 가이드입니다. Gemini 및 Gemma 4와 같은 최신 모델을 지원하며, 텍스트, 이미지, 오디오, 비디오를 포함한 멀티모달 입력을 처리할 수 있습니다. 주요 기능으로는 함수 호출(function calling)을 통한 외부 도구 연동, JSON 스키마 기반의 구조화된 출력 생성, 그리고 Python, JavaScript/TypeScript, Java, Go 등 다양한 언어를 위한 공식 SDK(google-genai, @google/genai 등) 사용법을 상세히 다룹니다. 개발자는 이 스킬을 통해 모델 선택, API 키 관리, 프롬프트 최적화, 멀티턴 대화, 안전성 설정, 그리고 Gemini API의 다양한 캐퍼빌리티(예: 콘텐츠 생성, 임베딩, 토큰 계산)를 실제 코드 예제와 함께 습득할 수 있습니다. SKILL.md 문서는 공식 Google Gemini API 문서를 기반으로 하여, 최신 모델 사양과 API 엔드포인트 변경 사항을 반영합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/google-gemini/gemini-skills/tree/main/skills/gemini-api-dev

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

gemini-api-dev은(는) 무엇을 하나요?

이 스킬은 Gemini API 호스팅 모델(Gemini, Gemma 4 포함)로 애플리케이션을 구축하고, 멀티모달 콘텐츠(텍스트, 이미지, 오디오, 비디오)를 처리하며, 함수 호출을 구현하고, 구조화된 출력을 사용하거나 최신 모델 사양이 필요할 때 사용합니다. SDK 사용법(Python용 google-genai, JavaScript/TypeScript용 @google/genai, Java용 com.google.genai:google-genai, Go용 google.golang.org/genai), 모델 선택, API 기능을 다룹니다.

기능

  • 멀티모달 입력: 텍스트, 이미지, 오디오, 비디오를 동시에 처리합니다.
  • 함수 호출: 외부 API나 도구를 Gemini 모델에 연결합니다.
  • 구조화된 출력: JSON 스키마를 정의하여 일관된 형식의 응답을 얻습니다.
  • SDK 지원: Python, JavaScript/TypeScript, Java, Go용 공식 SDK를 사용합니다.

주요 SDK 사용 예시

Python (google-genai)

from google import genai
from google.genai import types

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="What is in this photo?",
    config=types.GenerateContentConfig(
        temperature=0.7,
        max_output_tokens=100,
    ),
)
print(response.text)

JavaScript/TypeScript (@google/genai)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

const response = await ai.models.generateContent({
  model: "gemini-2.0-flash",
  contents: "Explain quantum computing in simple terms.",
});

console.log(response.text);

모델 선택 가이드

모델설명사용 사례
Gemini 2.0 Flash빠른 응답 속도, 멀티모달실시간 채팅, 간단한 질문
Gemini 2.0 Pro높은 정확도, 긴 컨텍스트복잡한 추론, 문서 분석
Gemma 4경량화된 오픈 모델엣지 디바이스, 커스터마이징

필수 환경 변수

  • GEMINI_API_KEY: Google AI Studio에서 발급받은 API 키.

참고 자료

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

google-gemini/gemini-interactions-api

Use this skill when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, streaming responses, background research tasks, function calling, structured output, or migrating from the old generateContent API. This skill covers the Interactions API, the recommended way to use Gemini models and agents in Python and TypeScript.

google-gemini/gemini-live-api-dev

Use this skill when building real-time, bidirectional streaming applications with the Gemini Live API. Covers WebSocket-based audio/video/text streaming, voice activity detection (VAD), native audio features, function calling, session management, ephemeral tokens for client-side auth, live translation, and all Live API configuration options. SDKs covered - google-genai (Python), @google/genai (JavaScript/TypeScript).

google-gemini/gemini-skills

Use this skill for generative video editing, text-to-video, image-referenced video generation, first-frame-to-video, first-and-last-frame transitions, and video extensions using Gemini Omni 1.1 Flash (gemini-omni-1.1-flash) via the official google-genai SDK. Includes workflows for pre-processing/optimizing high-resolution or long source videos with ffmpeg, stripping audio for full sound regeneration, and handling turn-by-turn video editing and parallel execution.

google-gemini/vertex-ai-api-dev

Guides the usage of Gemini API on Google Cloud Vertex AI with the Gen AI SDK. Use when the user asks about using Gemini in an enterprise environment or explicitly mentions Vertex AI. Covers SDK usage (Python, JS/TS, Go, Java, C#), capabilities like Live API, tools, multimedia generation, caching, and batch prediction.

관련 스킬