채팅 완성

통합 API를 통해 다양한 AI 모델로 대화형 응답을 생성합니다.

채팅 완성 생성

POST https://aiberm.com/v1/chat/completions

1curl https://aiberm.com/v1/chat/completions \
2-H "Content-Type: application/json" \
3-H "Authorization: Bearer YOUR_API_KEY" \
4-d '{
5 "model": "gpt-4",
6 "messages": [
7 {"role": "system", "content": "You are a helpful assistant."},
8 {"role": "user", "content": "What is the capital of France?"}
9 ],
10 "temperature": 0.7
11}'

요청 파라미터

파라미터타입필수설명
modelstring사용할 모델의 ID
messagesarray메시지 객체 배열
temperaturenumber아니요샘플링 온도 (0-2). 기본값: 1
max_tokensinteger아니요생성할 최대 토큰 수
top_pnumber아니요핵 샘플링(nucleus sampling) 파라미터
streamboolean아니요응답을 스트리밍할지 여부

메시지 역할

메시지에는 rolecontent가 포함되어야 합니다.

  • system - 어시스턴트의 행동/성격을 설정합니다
  • user - 최종 사용자의 메시지입니다
  • assistant - AI의 이전 응답입니다

스트리밍 응답

스트리밍을 활성화하면 응답을 점진적으로 받을 수 있습니다.

1from openai import OpenAI
2 
3client = OpenAI(
4 api_key="YOUR_API_KEY",
5 base_url="https://aiberm.com/v1"
6)
7 
8stream = client.chat.completions.create(
9 model="gpt-4",
10 messages=[{"role": "user", "content": "Tell me a story"}],
11 stream=True
12)
13 
14for chunk in stream:
15 if chunk.choices[0].delta.content:
16 print(chunk.choices[0].delta.content, end="")

모범 사례

요청 최적화하기
  • max_tokens를 설정해 비용을 제한하세요
  • 용도에 맞는 temperature 값을 사용하세요 (사실 기반은 낮게, 창의적인 작업은 높게)
  • 시스템 메시지를 포함해 동작을 안내하세요
  • 더 나은 UX를 위해 응답을 스트리밍하세요
Warning

각 모델의 토큰 한도를 염두에 두세요. 대화가 길어지면 대화 이력을 관리해야 할 수 있습니다.