완성 만들기

POST

https://api.openai.com/v1/completions

제공된 프롬프트 및 매개변수에 대한 완성을 만듭니다.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/completions' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "text-davinci-003",
  "prompt": "Say this is a test",
  "max_tokens": 7,
  "temperature": 0,
  "top_p": 1,
  "n": 1,
  "stream": false,
  "logprobs": null,
  "stop": "\n"
}'

Response Example

{
  "id": "cmpl-uqkvlQyYK7bGYrRHQ0eXlWi7",
  "object": "text_completion",
  "created": 1589478378,
  "model": "text-davinci-003",
  "choices": [
    {
      "text": "\n\nThis is indeed a test",
      "index": 0,
      "logprobs": null,
      "finish_reason": "length"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 7,
    "total_tokens": 12
  }
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

model

string

required

사용할 모델의 ID입니다. 모델 목록 API를 사용하여 사용 가능한 모든 모델을 확인하거나 모델 개요 에서 해당 모델에 대한 설명을 볼 수 있습니다.

prompt

string

required

문자열, 문자열 배열, 토큰 배열 또는 토큰 배열로 인코딩된 완성을 생성하기 위한 프롬프트입니다. <|endoftext|>는 훈련 중에 모델이 보는 문서 구분 기호이므로 프롬프트가 지정되지 않으면 모델은 새 문서의 시작 부분부터 생성되는 것처럼 생성됩니다.

suffix

string

optional

삽입된 텍스트가 완료된 뒤에 오는 접미사입니다.

max_tokens

integer

optional

완료 시 생성할 최대 토큰 수입니다. 프롬프트의 토큰 수에 max_tokens 더한 값은 모델의 컨텍스트 길이를 초과할 수 없습니다. 토큰 계산을 위한 Python 코드 예시 .

temperature

integer

optional

사용할 샘플링 온도는 0에서 2 사이입니다. 0.8과 같이 값이 높을수록 출력이 더욱 무작위로 생성되고, 0.2와 같이 값이 낮을수록 더욱 집중적이고 결정적이게 됩니다. 일반적으로 이 항목이나 top_p 변경하는 것이 좋지만 둘 다 변경하지는 않는 것이 좋습니다.

top_p

integer

optional

핵 샘플링이라고 하는 온도 샘플링의 대안으로, 모델은 확률 질량이 top_p인 토큰의 결과를 고려합니다. 따라서 0.1은 상위 10% 확률 질량을 구성하는 토큰만 고려된다는 의미입니다. 일반적으로 이 온도나 temperature 변경하는 것이 좋지만 둘 다 변경하는 것은 권장되지 않습니다.

integer

optional

각 프롬프트에 대해 생성할 완료 횟수입니다. 참고: 이 매개변수는 많은 완료를 생성하므로 토큰 할당량을 빠르게 소모할 수 있습니다. 주의 깊게 사용하고 max_tokens 및 stop 에 대한 적절한 설정이 있는지 확인하십시오.

stream

boolean

optional

부분 진행률을 다시 스트리밍할지 여부입니다. 설정된 경우 토큰은 사용 가능해지면 데이터 전용 서버 전송 이벤트 로 전송되며 스트림은 data: [DONE] 메시지로 종료됩니다. 예제 Python 코드 .

logprobs

null

optional

logprobs 가장 가능성이 높은 토큰과 선택한 토큰에 대한 로그 확률을 포함합니다. 예를 들어, logprobs 5인 경우 API는 가장 가능성이 높은 5개의 토큰 목록을 반환합니다. API는 항상 샘플링된 토큰의 logprob 반환하므로 응답에는 최대 logprobs+1 요소가 있을 수 있습니다. logprobs 의 최대값은 5입니다.

echo

string

optional

완료와 함께 프롬프트를 다시 에코합니다.

presence_penalty

number

optional

-2.0과 2.0 사이의 숫자입니다. 양수 값은 지금까지 텍스트에 나타나는지 여부에 따라 새 토큰에 불이익을 주어 모델이 새로운 주제에 관해 이야기할 가능성을 높입니다. 빈도 및 출석 페널티에 대한 자세한 내용을 확인하세요.

frequency_penalty

number

optional

-2.0과 2.0 사이의 숫자입니다. 양수 값은 지금까지 텍스트의 기존 빈도를 기반으로 새 토큰에 불이익을 주어 모델이 동일한 줄을 그대로 반복할 가능성을 줄입니다. 빈도 및 출석 페널티에 대한 자세한 내용을 확인하세요.

best_of

integer

optional

서버 측에서 best_of 완료를 생성하고 "최고"(토큰당 로그 확률이 가장 높은 것)를 반환합니다. 결과를 스트리밍할 수 없습니다. n 과 함께 사용하면 best_of 후보 완료 횟수를 제어하고 n 반환할 횟수를 지정합니다. best_of n 보다 커야 합니다. 참고: 이 매개변수는 많은 완료를 생성하므로 토큰 할당량을 빠르게 소모할 수 있습니다. 주의 깊게 사용하고 max_tokens 및 stop 에 대한 적절한 설정이 있는지 확인하십시오.

logit_bias

string

optional

특정 토큰이 완료 시 나타날 가능성을 수정합니다. 토큰(GPT 토크나이저의 토큰 ID로 지정됨)을 -100에서 100까지의 관련 바이어스 값에 매핑하는 json 개체를 허용합니다. 이 토크나이저 도구 (GPT-2 및 GPT-3 모두에서 작동)를 사용하여 변환할 수 있습니다. 텍스트를 토큰 ID로 변환합니다. 수학적으로 편향은 샘플링 전에 모델에 의해 생성된 로짓에 추가됩니다. 정확한 효과는 모델마다 다르지만 -1과 1 사이의 값은 선택 가능성을 줄이거나 늘려야 합니다. -100 또는 100과 같은 값은 관련 토큰의 금지 또는 독점 선택을 초래해야 합니다. 예를 들어, {"50256": -100} 전달하여 <|endoftext|> 토큰이 생성되는 것을 방지할 수 있습니다.

stop

string

optional

API가 추가 토큰 생성을 중지하는 최대 4개의 시퀀스입니다. 반환된 텍스트에는 중지 시퀀스가 포함되지 않습니다.

user

string

optional

OpenAI가 남용을 모니터링하고 감지하는 데 도움이 될 수 있는 최종 사용자를 나타내는 고유 식별자입니다. 자세히 알아보기

Examples

Responses

🟢200Ok

application/json

Body

string

required

object

string

required

created

integer

required

model

string

required

choices

array [object {4}]

required

text

string

optional

index

integer

optional

logprobs

null

optional

finish_reason

string

optional

usage

object

required

prompt_tokens

integer

required

completion_tokens

integer

required

total_tokens

integer

required

소송 비용

어시스턴트 생성(v1)