메인 콘텐츠로 건너뛰기
POST
/
v1beta
/
models
/
{model}
:
{method}
curl --request POST \
  --url https://api.apimart.ai/v1beta/models/gemini-2.5-pro:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "안녕하세요, 자기소개를 해주세요"
        }
      ]
    }
  ]
}'
{
  "code": 200,
  "data": {
    "candidates": [
      {
        "content": {
          "role": "model",
          "parts": [
            {
              "text": "안녕하세요! 제 소개를 드리겠습니다.\n\n저는 Google에서 훈련하고 개발한 대규모 언어 모델입니다..."
            }
          ]
        },
        "finishReason": "STOP",
        "index": 0,
        "safetyRatings": [
          {
            "category": "HARM_CATEGORY_HATE_SPEECH",
            "probability": "NEGLIGIBLE"
          }
        ]
      }
    ],
    "promptFeedback": {
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HATE_SPEECH",
          "probability": "NEGLIGIBLE"
        }
      ]
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  }
}
curl --request POST \
  --url https://api.apimart.ai/v1beta/models/gemini-2.5-pro:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "안녕하세요, 자기소개를 해주세요"
        }
      ]
    }
  ]
}'
{
  "code": 200,
  "data": {
    "candidates": [
      {
        "content": {
          "role": "model",
          "parts": [
            {
              "text": "안녕하세요! 제 소개를 드리겠습니다.\n\n저는 Google에서 훈련하고 개발한 대규모 언어 모델입니다..."
            }
          ]
        },
        "finishReason": "STOP",
        "index": 0,
        "safetyRatings": [
          {
            "category": "HARM_CATEGORY_HATE_SPEECH",
            "probability": "NEGLIGIBLE"
          }
        ]
      }
    ],
    "promptFeedback": {
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HATE_SPEECH",
          "probability": "NEGLIGIBLE"
        }
      ]
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  }
}

인증

Authorization
string
required
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 가져오기:API 키 관리 페이지를 방문하여 API 키를 가져오세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

경로 매개변수

model
string
required
모델 이름예제에서는 gemini-2.5-pro를 사용하며, 다른 지원되는 Gemini 모델로 대체할 수 있습니다:
  • gemini-2.5-flash - Gemini 2.5 고속 버전
  • gemini-2.5-pro - Gemini 2.5 전문 버전
  • gemini-2.5-flash-lite - Gemini 2.5 초경량 버전
  • gemini-2.5-pro-thinking - Gemini 2.5 Pro 심층 사고 버전
method
enum<string>
required
생성 방법 (빠른 시작에는 generateContent 권장):
  • generateContent: 완전한 응답을 기다린 후 한 번에 반환
  • streamGenerateContent: 스트림 형식으로 단계적으로 콘텐츠 반환
사용 가능한 옵션: generateContent, streamGenerateContent

본문

contents
array
required
대화 내용 목록최소 1개의 메시지가 필요합니다예:
[
  {
    "role": "user",
    "parts": [{ "text": "안녕하세요, 자기소개를 해주세요" }]
  }
]
generationConfig
object
생성 구성 (선택사항)
safetySettings
array
안전 설정 (선택사항)

응답

candidates
array
후보 응답 목록
promptFeedback
object
프롬프트 피드백 정보
usageMetadata
object
사용량 통계