엔드포인트 규약
Starmodel 는 하나의 OpenAI 호환 게이트웨이만 제공합니다. 모든 요청은 동일한 base URL 로 전송되며, 경로가 기능을, model 필드가 모델을 결정합니다.
Base URL
https://api.starmodel.ai/v1당신의 게이트웨이 도메인입니다. 아래 엔드포인트 경로를 뒤에 붙이고, 모든 요청은 Authorization: Bearer $API_KEY 로 인증하세요.
엔드포인트 목록
| 기능 | 메서드 | 경로 |
|---|---|---|
| 채팅 완성 | POST | /v1/chat/completions |
| Anthropic messages | POST | /v1/messages |
| Responses API | POST | /v1/responses |
| 이미지 생성 | POST | /v1/images/generations |
| 이미지 편집 | POST | /v1/images/edits |
| 비디오 생성 | POST | /v1/videos/generations |
| 음성 합성 | POST | /v1/audio/speech |
| 모델 목록 | GET | /v1/models |
동기 vs 비동기
Chat, messages, responses 는 단일 HTTP 요청 안에서 응답합니다. stream: true 로 설정하면 Server-Sent Events(text/event-stream)로 반환되며 data: [DONE] 로 종료됩니다.
이미지, 비디오, 음성 생성은 업스트림에서 오래 걸리는 작업이지만, 게이트웨이가 대신 작업을 폴링하여 통합된 동기 JSON 결과를 반환합니다 — 폴링할 task id 가 없습니다. 비디오는 클라이언트 타임아웃을 크게 설정하세요. 레이트 리밋된 요청은 Retry-After 헤더와 함께 HTTP 429 를 반환합니다.
직접 연동에서 마이그레이션
엔드포인트가 OpenAI 호환이므로 대부분의 경우 base_url 만 바꾸면 됩니다:
- client = OpenAI(api_key=OPENAI_KEY)+ client = OpenAI(+ api_key=SEEAI_KEY,+ base_url="https://api.starmodel.ai/v1",+ )Anthropic SDK 를 쓰시나요? 해당 SDK 의 base_url 을 같은 게이트웨이로 지정하고 /v1/messages 를 호출하세요.