메인 콘텐츠로 건너뛰기
POST
/
v1beta
/
models
/
{model}
:generateContent
curl -X POST "https://api.lemondata.cc/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}
LemonData는 Gemini 모델에 대해 네이티브 Google Gemini API 형식을 지원합니다. 이를 통해 Google AI SDK와 직접적인 호환이 가능합니다.

경로 파라미터

model
string
필수
모델 이름 (예: gemini-2.5-pro, gemini-2.5-flash).

쿼리 파라미터

key
string
API 키 (헤더 인증의 대안).

인증

Gemini 엔드포인트는 여러 인증 방법을 지원합니다:
  • ?key=YOUR_API_KEY 쿼리 파라미터
  • x-goog-api-key: YOUR_API_KEY 헤더
  • Authorization: Bearer YOUR_API_KEY 헤더

요청 본문

contents
array
필수
대화 내용.각 콘텐츠 객체는 다음을 포함합니다:
  • role (string): user 또는 model
  • parts (array): 콘텐츠 파트 (text 또는 inline data)
systemInstruction
object
모델을 위한 시스템 지침.
generationConfig
object
생성 설정:
  • temperature (number): 샘플링 온도
  • topP (number): Nucleus 샘플링 확률
  • topK (integer): Top-K 샘플링
  • maxOutputTokens (integer): 최대 출력 토큰 수
  • stopSequences (array): 중단 시퀀스
safetySettings
array
안전 필터 설정.

응답

candidates
array
생성된 콘텐츠 후보.
usageMetadata
object
토큰 사용 정보.
curl -X POST "https://api.lemondata.cc/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}