API 개요
게이트웨이가 제공하는 모든 엔드포인트와 각 엔드포인트가 사용하는 형식 및 반환하는 내용.
세 개의 엔드포인트. 두 가지 요청 형식. 하나의 키.
| 메서드 | 경로 | 형식 | 용도 |
|---|---|---|---|
| POST | /v1/messages | Anthropic Messages | 채팅 완성, Anthropic 봉투 형식 |
| POST | /v1/chat/completions | OpenAI 채팅 완성 | 채팅 완성, OpenAI 응답 구조 |
| GET | /v1/models | OpenAI 형식 목록 | 키로 호출할 수 있는 모델 ID |
기계가 읽을 수 있는 설명이 다음 위치에 게시되어 있습니다: /openapi.json, 전체 사이트의 일반 텍스트 요약은 다음 위치에 있습니다: /llms.txt 및 /llms-full.txt.
엔드포인트 선택
이 엔드포인트들은 다음을 제공합니다: 동일한 가격의 동일한 모델. 클라이언트가 이미 사용하는 형식에 따라 선택하세요. 형식을 직접 변환하지 마세요.
| 엔드포인트 | 인증 헤더 | 응답 구조 | 스트리밍 |
|---|---|---|---|
/v1/messages | x-api-key 또는 Bearer | content[] 배열 + usage | SSE, content_block_delta 이벤트 |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content 청크 |
스트리밍 구조는 서로 다르며 호환되지 않습니다. 다음 형식에 맞춰 작성된 클라이언트는
choices[].delta.content Messages 스트림에서 아무것도 읽지 못합니다. 다음을 참고하세요: 스트리밍.공통 헤더
| 헤더 | 적용 대상 | 참고 사항 |
|---|---|---|
content-type: application/json | 두 POST 요청 모두 | 필수 여부 |
x-api-key | 메시지 | Anthropic 형식 |
Authorization: Bearer | 둘 다 | OpenAI 형식이며 Messages에서도 허용됨 |
anthropic-version: 2023-06-01 | 메시지 | Anthropic SDK가 자동으로 설정 |
accept: text/event-stream | 둘 다 | SDK가 다음 조건일 때 설정: stream 값이 true인 경우 |