입력 메시지가 지정된 모델에서 응답을 생성합니다.
HTTP 요청
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateText
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
model |
필수 항목입니다. 완료 항목을 생성하는 데 사용할 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "prompt": { object ( |
필드 | |
---|---|
prompt |
필수 항목입니다. 모델에 프롬프트로 지정된 자유 형식 입력 텍스트입니다. 프롬프트가 주어지면 모델은 입력 텍스트의 완료로 예측되는 Textcomplete 응답을 생성합니다. |
safetySettings[] |
선택사항입니다. 안전하지 않은 콘텐츠를 차단하기 위한 고유
|
stopSequences[] |
출력 생성을 중지할 문자 시퀀스의 집합입니다 (최대 5개). 지정된 경우 중지 시퀀스가 처음 나타날 때 API가 중지됩니다. 중지 시퀀스는 응답에 포함되지 않습니다. |
temperature |
선택사항입니다. 출력의 무작위성을 제어합니다. 참고: 기본값은 모델에 따라 다릅니다. 값의 범위는 [0.0,1.0] 이상입니다. 값이 1.0에 가까우면 더 다양하고 창의적인 응답을 생성하며, 0.0에 가까울수록 일반적으로 모델에서 더 간단한 응답이 발생합니다. |
candidateCount |
선택사항입니다. 반환할 생성된 응답 수입니다. 이 값은 [1, 8] 이하여야 합니다. 설정하지 않으면 기본값은 1입니다. |
maxOutputTokens |
선택사항입니다. 후보에 포함할 수 있는 최대 토큰 수입니다. 설정하지 않으면 기본값은 |
topP |
선택사항입니다. 샘플링 시 고려할 토큰의 최대 누적 확률입니다. 이 모델은 결합된 최상위 K 및 핵 샘플링을 사용합니다. 할당된 확률을 기준으로 토큰이 정렬되므로 가장 가능성이 높은 토큰만 고려됩니다. 최상위 K 샘플링은 고려할 최대 토큰 수를 직접적으로 제한하는 반면, Nucleus 샘플링은 누적 확률을 기준으로 토큰 수를 제한합니다. 참고: 기본값은 모델에 따라 다릅니다. |
topK |
선택사항입니다. 샘플링할 때 고려할 최대 토큰 수입니다. 이 모델은 결합된 최상위 K 및 핵 샘플링을 사용합니다. 최상위 K 샘플링은 가능성이 가장 높은 토큰 참고: 기본값은 모델에 따라 다릅니다. |
응답 본문
성공한 경우 응답 본문에 GenerateTextResponse
의 인스턴스가 포함됩니다.
승인 범위
다음 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
자세한 내용은 인증 개요를 참조하세요.