인증
모든 API 요청은 API 키를 사용한 인증이 필요합니다. 모든 요청의 Authorization 헤더에 API 키를 포함하세요.
헤더 예제
Authorization: Bearer YOUR_API_KEY중요: API 키를 안전하게 보관하고 클라이언트 측 코드에 노출하지 마세요.
속도 제한
무료 티어
1,000
하루 요청 수
분당
60
분당 요청 수
컨텍스트 윈도우
1M
토큰 컨텍스트 윈도우
API 엔드포인트
POST
/v1/generateGenerate text using Gemini models
요청
curl -X POST \
https://api.gemini-guide.com/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Your prompt here"}'
응답
{
"status": "success",
"data": {
"response": "Generated content...",
"model": "gemini-pro",
"usage": {
"tokens": 150
}
}
}
POST
/v1/chatStart or continue a chat conversation
요청
curl -X POST \
https://api.gemini-guide.com/v1/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Your prompt here"}'
응답
{
"status": "success",
"data": {
"response": "Generated content...",
"model": "gemini-pro",
"usage": {
"tokens": 150
}
}
}
GET
/v1/modelsList available models
요청
curl -X GET \
https://api.gemini-guide.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" \
응답
{
"status": "success",
"data": {
"response": "Generated content...",
"model": "gemini-pro",
"usage": {
"tokens": 150
}
}
}
GET
/v1/usageGet API usage statistics
요청
curl -X GET \
https://api.gemini-guide.com/v1/usage \
-H "Authorization: Bearer YOUR_API_KEY" \
응답
{
"status": "success",
"data": {
"response": "Generated content...",
"model": "gemini-pro",
"usage": {
"tokens": 150
}
}
}
오류 코드
400Bad Request
Invalid request parameters
401Unauthorized
Invalid or missing API key
429Too Many Requests
Rate limit exceeded
500Internal Server Error
Server error occurred