본문으로 건너뛰기
문서

문서 메뉴

채팅 완성 (OpenAI 호환)

POST /v1/chat/completions - 요청 필드, 응답 구조, 허용되지만 적용되지 않는 필드.

최종 업데이트 2026-11-04

POST https://api.ticonai.com/v1/chat/completions는 OpenAI Chat Completions 형식을 따릅니다. 기본 URL과 키만 바꾸면 OpenAI SDK가 동작합니다.

bash
curl -sS https://api.ticonai.com/v1/chat/completions \
  -H "Authorization: Bearer $AIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "your-model-id", "messages": [{ "role": "user", "content": "안녕하세요" }], "max_tokens": 64 }'

주요 필드

  • model과 messages는 필수입니다. system과 developer 메시지는 합쳐져 시스템 프롬프트가 됩니다.
  • max_tokens 또는 max_completion_tokens: 생성 토큰 상한. 생략하면 모델 기본값이 적용됩니다.
  • temperature(02), top_p(01), stop(최대 16개), stream, stream_options.include_usage.
  • n은 1만 지원합니다.
  • response_format, user 등은 허용되지만 이 버전에서는 적용되지 않습니다.
  • 본문은 application/json, 최대 2 MiB입니다.

응답에는 choices[0].message.content(텍스트), finish_reason, usage가 포함됩니다. 오류 코드는 오류 페이지를 참고하세요. 자세한 내용은 영어 문서에 있습니다.