지원 엔드포인트
구현하려는 작업에 맞는 API 엔드포인트와 응답 경로를 찾으세요.
OpenAI 호환 및 Anthropic 네이티브 엔드포인트의 경로와 결과 위치를 비교합니다.
Base URL과 인증
경로에 따라 base URL과 인증 헤더가 두 가지로 나뉩니다. 세부 설정은 인증에서 확인합니다.
| 경로 | base URL | 인증 헤더 |
|---|---|---|
| OpenAI 호환 | https://gw.letsur.ai/v1 | Authorization: Bearer <API_KEY> |
Anthropic 네이티브 (/v1/messages) | https://gw.letsur.ai | x-api-key: <API_KEY> + anthropic-version: 2023-06-01 |
작업별 엔드포인트
- Chat Completions
POST /v1/chat/completions경로의 텍스트와 이미지 입력 및 스트리밍을 다룹니다.- Responses
POST /v1/responses경로와 Responses 형식의 결과를 다룹니다.- Embeddings
POST /v1/embeddings경로로 임베딩을 생성합니다.- Image Generations
POST /v1/images/generations경로로 프롬프트에서 이미지를 생성합니다.- Image Edits
POST /v1/images/edits경로로 입력 이미지를 프롬프트에 맞게 편집합니다.- Models
GET /v1/models경로로 사용할 수 있는 모델을 조회합니다.- Messages
- Anthropic 네이티브
POST /v1/messages경로를 다룹니다.
응답에서 결과 찾기
응답 JSON 구조는 엔드포인트마다 다릅니다. 모델이 생성한 결과를 꺼내는 위치만 모아 정리합니다.
| 엔드포인트 | 스키마 | 결과 경로 | SDK 편의 속성 |
|---|---|---|---|
/v1/chat/completions | OpenAI | choices[0].message.content | — |
/v1/chat/completions (이미지) | OpenAI + images 필드 | choices[0].message.images[0].image_url.url (base64) | — |
/v1/responses | OpenAI Responses | output[0].content[0].text | response.output_text |
/v1/embeddings | OpenAI | data[0].embedding | — |
/v1/images/generations | OpenAI Images | data[0].b64_json | response.data[0].b64_json |
/v1/images/edits | OpenAI Images | data[0].b64_json | response.data[0].b64_json |
/v1/messages | Anthropic | content[0].text | — |
엔드포인트별 지원 기능 비교
응답 형식과 지원 기능은 엔드포인트와 모델마다 다릅니다. 아래 표는 형식 선택을 위한 기준이며, 실제 모델의 현재 지원 범위는 에셋에서 확인합니다.
| 차원 | Chat Completions | Responses | Embeddings | Messages |
|---|---|---|---|---|
| 요청 형식 | messages[] | input (문자열 또는 배열) | input (문자열 또는 배열) | messages[] (Anthropic) |
| 결과 경로 | choices[0].message.content | output[0].content[0].text | data[0].embedding | content[0].text |
| 스트리밍 | 모델별 확인 | 모델별 확인 | 미지원 | 모델별 확인 |
| Tool calling | 모델별 확인 | 모델별 확인 | 미지원 | 모델별 확인 |
| 이미지 입력 | 모델별 확인 | 모델별 확인 | 미지원 | 모델별 확인 |
| JSON 모드 | 모델별 확인 | 모델별 확인 | 미지원 | 모델별 확인 |
이미지 작업
gpt-image-2는 모든 스페이스에 기본 제공되며 별도 배급 요청이 필요하지 않습니다. 이미지 생성과 편집은 비스트리밍으로 동작하고, 기존 AI 게이트웨이 API 키와 OpenAI 호환 클라이언트를 사용합니다. 인증, 월 한도, 비용과 사용량도 다른 게이트웨이 요청과 함께 관리됩니다.
| 작업 | 요청 형식 | 필수 입력 | 결과 경로 |
|---|---|---|---|
| 이미지 생성 | JSON | model, prompt | data[0].b64_json |
| 이미지 편집 | multipart form | model, prompt, image | data[0].b64_json |
성공 JSON 응답의 최상위 estimated_cost는 Chat Completions, Responses, Messages, Embeddings, Image Generations와 Image Edits에서 호출별 비용을 제공합니다. streaming에서는 누적 usage가 있는 event에서 확인하며 정확한 위치는 각 엔드포인트 문서를 따릅니다.
Chat Completions는 OpenAI 호환 채팅 형식을, Responses는 구조화된 output 형식을 사용합니다. Messages는 Anthropic 네이티브 형식이 필요한 클라이언트에서 사용합니다. Image Generations와 Image Edits는 현재 gpt-image-2를 지원하며, 다른 엔드포인트에서는 사용할 모델이 해당 API를 지원하는지 에셋에서 확인합니다.