텍스트GPTGPT-5.1

GPT-5.1 - 전체 API 레퍼런스

OpenAI SDK 형식을 사용하여 GPT-5.1 시리즈 모델 호출

동기 처리 모드, 실시간 응답
사용 가능한 모델: gpt-5.1 (기본), gpt-5.1-chat (대화 최적화), gpt-5.1-thinking (추론 출력 포함)
텍스트 대화: 단일 턴 또는 다중 턴 컨텍스트 대화
시스템 프롬프트: AI 역할 및 동작 사용자 정의
멀티모달 입력: 텍스트 + 이미지 혼합 입력 지원
도구 호출: Function Calling 지원
추론 출력: gpt-5.1-thinking은 사고 과정을 보여주는 reasoning_content 필드를 반환합니다

<Note> **BaseURL**: 기본 BaseURL은 `https://api.starmagic.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.starmagic.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. </Note>

인증

Authorizationstringheader필수

모든 API는 Bearer Token 인증이 필요합니다 **API Key 받기:** [API Key 관리 페이지](https://starmagic.ai/app/api-keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

요청 본문

application/json

modelenum<gpt-5.1 | gpt-5.1-chat | gpt-5.1-thinking>필수

채팅 완료를 위한 모델 이름 - **gpt-5.1**: 일반 작업용 기본 모델 - **gpt-5.1-chat**: 대화 작업에 최적화 - **gpt-5.1-thinking**: 사고 과정 출력이 포함된 추론 기능 (reasoning_content 반환)

"gpt-5.1"

messagesobject[]필수

대화를 위한 메시지 목록, 다중 턴 대화 및 멀티모달 입력 지원

[
  {
    "role": "user",
    "content": null
  }
]

streamboolean

응답을 스트리밍할지 여부 - `true`: 스트림 응답, 실시간으로 청크 단위로 내용 반환 - `false`: 완전한 응답을 기다린 후 한 번에 반환

false

max_tokensinteger

응답에서 생성할 최대 토큰 수

temperaturenumber

샘플링 온도, 출력의 무작위성을 제어합니다 - 낮은 값 (예: 0.2): 더 결정적이고 집중된 출력 - 높은 값 (예: 1.5): 더 무작위적이고 창의적인 출력

top_pnumber

Nucleus sampling 매개변수 - 누적 확률을 기반으로 토큰에서 샘플링을 제어합니다 - 예를 들어, 0.9는 누적 확률 상위 90%의 토큰에서 샘플링하는 것을 의미합니다

0.9

frequency_penaltynumber

빈도 페널티, -2.0에서 2.0 사이의 숫자 - 양수 값은 텍스트에서의 빈도에 따라 새 토큰에 페널티를 부여합니다

presence_penaltynumber

존재 페널티, -2.0에서 2.0 사이의 숫자 - 양수 값은 텍스트에 나타나는지 여부에 따라 새 토큰에 페널티를 부여합니다

stopobject

중지 시퀀스, 이 시퀀스가 일치하면 생성이 중지됩니다

toolsobject[]

Function Calling을 위한 도구 목록

[
  {
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "주어진 위치의 현재 날씨를 가져옵니다",
      "parameters": {}
    }
  }
]

응답

application/json

成功

응답 본문

idstring

채팅 완성의 고유 식별자

"chatcmpl-abc123"

modelstring

완료에 사용된 모델

"gpt-5.1"

objectenum<chat.completion>

응답 유형

"chat.completion"

createdinteger

완료가 생성된 Unix 타임스탬프

1698999496

choicesobject[]

완료 선택 목록

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hi there! How can I help you?",
      "reasoning_content": "Let me think about this step by step..."
    },
    "finish_reason": "stop"
  }
]

usageobject

토큰 사용 통계

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}

POST/v1/chat/completions

curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself"
    }
  ],
  "temperature": 1
}'

응답: 成功

{
  "id": "chatcmpl-abc123",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null,
        "reasoning_content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

GPT-5.1 - 전체 API 레퍼런스

OpenAI SDK 형식을 사용하여 GPT-5.1 시리즈 모델 호출

동기 처리 모드, 실시간 응답

사용 가능한 모델: gpt-5.1 (기본), gpt-5.1-chat (대화 최적화), gpt-5.1-thinking (추론 출력 포함)

텍스트 대화: 단일 턴 또는 다중 턴 컨텍스트 대화

시스템 프롬프트: AI 역할 및 동작 사용자 정의

멀티모달 입력: 텍스트 + 이미지 혼합 입력 지원

도구 호출: Function Calling 지원

추론 출력: gpt-5.1-thinking은 사고 과정을 보여주는 reasoning_content 필드를 반환합니다

[ { "index": 0, "message": { "role": "assistant", "content": "Hi there! How can I help you?", "reasoning_content": "Let me think about this step by step..." }, "finish_reason": "stop" } ]