프로토콜 선택

기존 애플리케이션과 유지해야 할 기능에 맞는 언어 모델 호출 프로토콜을 선택합니다.

AGTCloud는 여러 언어 모델 호출 프로토콜을 제공합니다. 기존 애플리케이션의 SDK와 요청 구조를 그대로 사용하거나, 필요한 기능에 맞춰 새로운 프로토콜 엔드포인트를 선택할 수 있습니다.

처음 연동할 때는 OpenAI Chat으로 시작합니다

특정 SDK나 프로토콜 요구 사항이 없다면 OpenAI Chat Completions로 첫 호출을 진행할 수 있습니다.

호출 프로토콜이란

API 프로토콜은 요청 주소, 인증 방식, 요청 필드, 응답 구조와 스트리밍 이벤트 형식을 정의합니다. 프로토콜마다 데이터 구조가 다르므로 클라이언트는 선택한 프로토콜에 맞춰 요청을 보내고 응답을 해석해야 합니다.

이 페이지는 언어 모델 호출 프로토콜만 다루며 이미지, 비디오 및 오디오 API는 포함하지 않습니다.

프로토콜은 요청 필드, 응답 구조와 스트리밍 이벤트의 구성 방식을 결정하고, 모델은 실제로 사용할 AI 기능을 결정합니다. 다음 순서로 선택할 수 있습니다:

기존 프로젝트는 현재 SDK에 맞는 프로토콜을 계속 사용하여 요청 구조와 응답 처리의 변경을 줄일 수 있습니다.

애플리케이션에 특정 콘텐츠 구조, 도구 호출, 추론 정보 또는 상태 관리 방식이 필요하다면 해당 필드를 표현할 수 있는 프로토콜을 선택합니다.

먼저 모델 목록에서 대상 모델과 계정 권한을 확인한 후 해당 API 레퍼런스에 따라 호출합니다.

프로토콜	적합한 상황	주요 구조	API Reference
OpenAI Chat Completions	일반 대화 또는 기존 OpenAI Chat 애플리케이션	`messages`, `choices`	Chat Completions
OpenAI Responses	Responses 요청 구조를 사용하는 애플리케이션	`input`, Response Items	OpenAI Responses
Anthropic Messages	Anthropic SDK 또는 Messages 구조를 사용하는 애플리케이션	`messages`, Content Blocks	Anthropic Messages
Gemini Generate Content	Gemini SDK 또는 Contents/Parts 구조를 사용하는 애플리케이션	`contents`, Parts	Gemini Generate Content

프로토콜마다 필드 이름과 응답 구조가 다릅니다. 클라이언트는 선택한 엔드포인트의 API 레퍼런스에 따라 요청을 구성하고 응답을 해석해야 하며, 서로 다른 프로토콜의 필드를 혼용해서는 안 됩니다.

다음 호출 URL은 현재 사이트에 따라 자동으로 갱신됩니다:

OpenAI Chat Completions
호출 URL: POST https://api.agtcloud.cn/v1/chat/completions
OpenAI Responses
호출 URL: POST https://api.agtcloud.cn/v1/responses
Anthropic Messages
호출 URL: POST https://api.agtcloud.cn/v1/messages
Gemini Generate Content
호출 URL: POST https://api.agtcloud.cn/v1beta/models/{model}:generateContent

AGTCloud는 프로토콜 변환을 지원하지만, 변환이 모든 매개변수의 100% 호환을 의미하지는 않습니다.