Method: models.generateMessage

입력 MessagePrompt가 지정된 모델에서 응답을 생성합니다.

HTTP 요청

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateMessage

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
model

string

필수 항목입니다. 사용할 모델의 이름입니다.

형식은 name=models/{model}입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "prompt": {
    object (MessagePrompt)
  },
  "temperature": number,
  "candidateCount": integer,
  "topP": number,
  "topK": integer
}
필드
prompt

object (MessagePrompt)

필수 항목입니다. 모델에 프롬프트로 제공된 구조화된 텍스트 입력입니다.

프롬프트가 주어지면 모델이 토론의 다음 메시지라고 예측하는 내용을 반환합니다.
temperature

number

선택사항입니다. 출력의 무작위성을 제어합니다.

값의 범위는 [0.0,1.0] 이상입니다(양 끝값 포함). 값이 1.0에 가까울수록 더 다양한 응답이 생성되고, 값이 0.0에 가까울수록 일반적으로 모델에서 더 적은 응답을 얻게 됩니다.
candidateCount

integer

선택사항입니다. 반환할 생성된 응답 메시지 수입니다.

이 값은 [1, 8] 이하여야 합니다. 설정하지 않으면 기본값은 1입니다.
topP

number

선택사항입니다. 샘플링 시 고려할 토큰의 최대 누적 확률입니다.

이 모델은 결합된 최상위 K 및 핵 샘플링을 사용합니다.

핵 샘플링은 확률의 합이 topP 이상인 최소 토큰 세트를 고려합니다.
topK

integer

선택사항입니다. 샘플링할 때 고려할 최대 토큰 수입니다.

이 모델은 결합된 최상위 K 및 핵 샘플링을 사용합니다.

최상위 K 샘플링은 가능성이 가장 높은 토큰 topK개 집합을 고려합니다.

응답 본문

모델의 응답입니다.

여기에는 시간순으로 정렬된 메시지 형식의 후보 메시지와 대화 기록이 포함됩니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "candidates": [
    {
      object (Message)
    }
  ],
  "messages": [
    {
      object (Message)
    }
  ],
  "filters": [
    {
      object (ContentFilter)
    }
  ]
}
필드
candidates[]

object (Message)

모델의 후보 응답 메시지입니다.
messages[]

object (Message)

모델에서 사용하는 대화 기록입니다.
filters[]

object (ContentFilter)

프롬프트 및 응답 텍스트에 대한 콘텐츠 필터링 메타데이터 집합입니다.

이는 이 응답에서 후보를 차단한 SafetyCategory, 차단을 트리거한 가장 낮은 HarmProbability, 카테고리의 HarmThreshold 설정을 나타냅니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

자세한 내용은 인증 개요를 참조하세요.