API 연동 가이드
세 단계로 연동 완료: 가입 → API Key 발급 → 400+ 모델 호출. 전 과정이 OpenAI 호환이라 코드를 고치지 않고 모델을 바꿀 수 있습니다.
1회원가입 후 API Key 발급
- 가입 페이지에서 휴대폰 번호나 이메일로 가입을 마치세요. 가입만 해도 무료 크레딧을 드립니다.
- 플랫폼 안내에 따라 실명 인증(개인/기업 모두 가능)을 완료하면 계정 보안과 서비스 품질이 보장됩니다.
- 로그인한 뒤 대시보드의 'API 키' 페이지에서 API Key를 만드세요. Key는 생성 시 단 한 번만 표시되므로 잘 보관해 주세요.
💡 플랫폼은 BYOK(Bring Your Own Key)도 지원합니다. 자체 제공사 API Key를 연결하면 플랫폼 수수료가 면제되며, 키 관리와 사용량 분석, 할당량 제어를 한곳에서 처리할 수 있습니다.
2OpenAI SDK 설정 (Python)
APIGOTO 인터페이스는 OpenAI SDK와 완전히 호환됩니다. base_url과 api_key만 바꾸면 됩니다:
from openai import OpenAI
client = OpenAI(
base_url="https://api.apigoto.com/v1",
api_key="sk-your-api-key",
)
response = client.chat.completions.create(
model="anthropic/claude-sonnet-4",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)cURL로 호출하기
curl https://api.apigoto.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "deepseek/deepseek-chat",
"messages": [{"role": "user", "content": "Hello!"}]
}'3모델을 선택하고 호출을 시작합니다
플랫폼이 400+ 주요 모델과 70+ 모델 제공사를 통합 관리합니다. 플랫폼 모델명 하나만 기억하면 시스템이 자동으로 최적의 제공사로 라우팅하고, 장애가 나면 자동으로 페일오버합니다:
| 모델 기능 | 지원 제공사 | 약관 |
|---|---|---|
| 텍스트 대화 | Claude, GPT, Gemini, DeepSeek, Qwen 등 | OpenAI chat/completions、Anthropic messages |
| 이미지 생성 | GPT 계열 이미지 생성 모델 등 | OpenAI images |
| 동영상 생성 | 주요 동영상 모델 | OpenAI images 호환 인터페이스 |
| 벡터 임베딩 / 오디오 | 주요 Embeddings 및 음성 모델 | OpenAI Embeddings / 호환 프로토콜 |
⚡ 스마트 라우팅: 플랫폼이 「정확한 모델 → 정확한 프로토콜 → 연관 우선순위 → 제공사 우선순위 → 헬스 점수」 순으로 자동 선로하며, 같은 모델의 여러 제공사가 서로 백업이 되어 한 번의 요청에서 최대 3개 자격 증명까지 자동 전환합니다.
4과금 안내
- 사용량 기반 과금: 구독료가 없으며 실제 토큰 사용량에 따라 과금됩니다. 크레딧은 모든 모델과 제공사에 사용할 수 있습니다.
- 투명한 가격: 모델 가격 페이지에서 각 모델의 공식 가격과 플랫폼 가격을 실시간으로 확인할 수 있어 비용이 한눈에 들어옵니다.
- BYOK 무료: 보유한 제공사 Key로 호출하면 플랫폼 수수료가 없습니다.
- 잔액/포인트: 잔액 충전과 포인트 교환을 지원하며, Alipay로 온라인 결제할 수 있습니다.
자주 묻는 질문
연동한 뒤 모델은 어떻게 바꾸나요?
요청의 model 필드만 바꾸면 되며, 코드는 전혀 수정할 필요가 없습니다. 플랫폼 모델명과 상위 제공사의 실제 모델 ID는 시스템이 자동으로 매핑합니다.
스트리밍 출력을 지원하나요?
지원합니다. 요청에 stream: true를 추가하면 SSE 스트리밍 응답이 켜지며, OpenAI SDK의 스트리밍 방식과 호환됩니다.
API 호출이 실패하면 어떻게 하나요?
시스템이 자동으로 페일오버합니다. 그래도 실패한다면 피드백으로 알려 주세요. 영업일 기준으로 최대한 빠르게 처리하겠습니다.
호출 로그와 사용량은 어디에서 확인하나요?
대시보드에 로그인해 '호출 로그'와 '사용량 분석'에서 호출별 모델, 토큰, 비용 내역을 확인하세요.