채팅 완료 만들기

POST

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

지정된 채팅 대화에 대한 모델 응답을 생성합니다. 텍스트 생성 , 비전 및 오디오 가이드에서 자세히 알아보세요.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gpt-3.5-turbo",
  "messages": [{"role": "user", "content": "Hello!"}]
}'

Response Example

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "\n\nHello there, how may I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Content-Type

string

required

Example:

application/json

string

required

Example:

application/json

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

model

string

required

사용할 모델의 ID입니다. Chat API와 작동하는 모델에 대한 자세한 내용은 모델 엔드포인트 호환성 표를 참조하세요.

messages

array [object {2}]

required

지금까지의 대화를 구성하는 메시지 목록입니다. 예제 Python 코드 .

role

string

optional

The role of the messages author. One of system, user, assistant, or function.

content

string

optional

The contents of the message. content is required for all messages except assistant messages with function calls.

temperature

integer

optional

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

top_p

integer

optional

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

integer

optional

각 입력 메시지에 대해 생성할 채팅 완료 선택 항목 수입니다.

stream

boolean

optional

설정된 경우 ChatGPT와 같이 부분 메시지 델타가 전송됩니다. 토큰은 사용 가능해지면 데이터 전용 서버 전송 이벤트 로 전송되며 스트림은 data: [DONE] 메시지로 종료됩니다. 예제 Python 코드 .

stop

string

optional

API가 추가 토큰 생성을 중지하는 최대 4개의 시퀀스입니다.

max_tokens

integer

optional

채팅 완료 시 생성할 최대 토큰 수입니다. 입력 토큰과 생성된 토큰의 총 길이는 모델의 컨텍스트 길이에 따라 제한됩니다. 토큰 계산을 위한 Python 코드 예시 .

presence_penalty

number

optional

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

frequency_penalty

number

optional

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

logit_bias

null

optional

특정 토큰이 완료 시 나타날 가능성을 수정합니다. 토큰(토큰나이저의 토큰 ID로 지정됨)을 -100에서 100까지의 관련 편향 값에 매핑하는 json 객체를 허용합니다. 수학적으로 편향은 샘플링 전에 모델에서 생성된 로짓에 추가됩니다. 정확한 효과는 모델마다 다르지만 -1과 1 사이의 값은 선택 가능성을 줄이거나 늘려야 합니다. -100 또는 100과 같은 값은 관련 토큰의 금지 또는 독점 선택을 초래해야 합니다.

user

string

optional

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

Examples

Responses

🟢200OK

application/json

Body

string

required

object

string

required

created

integer

required

choices

array [object {3}]

required

index

integer

optional

message

object

optional

finish_reason

string

optional

usage

object

required

prompt_tokens

integer

required

completion_tokens

integer

required

total_tokens

integer

required

Modified at 2024-12-23 04:18:57

번역 만들기

임베딩 생성