API 연동 가이드
세 단계로 연동 완료: 가입 → API Key 발급 → 400+ 모델 호출. 전 과정이 OpenAI 호환이라 코드를 고치지 않고 모델을 바꿀 수 있습니다.
1회원가입 후 API Key 발급
- 가입 페이지에서 휴대폰 번호 또는 이메일로 가입하세요. 가입하면 무료 플랜이 자동으로 개통됩니다(동일 기기/네트워크당 1회).
- 플랫폼 안내에 따라 실명 인증(개인/기업 모두 가능)을 완료하면 계정 보안과 서비스 품질이 보장됩니다.
- 로그인한 뒤 대시보드의 '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="claude-sonnet-5",
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-v4-pro",
"messages": [{"role": "user", "content": "Hello!"}]
}'3모델을 선택하고 호출을 시작합니다
플랫폼이 400+ 주요 모델과 70+ 모델 제공사를 통합 관리합니다. 플랫폼 모델명 하나만 기억하면 시스템이 자동으로 최적의 제공사로 라우팅하고, 장애가 나면 자동으로 페일오버합니다:
| 모델 기능 | 지원 제공사 | 약관 |
|---|---|---|
| 텍스트 대화 | Claude, GPT, Gemini, DeepSeek, Qwen 등 | OpenAI chat/completions、Anthropic messages |
| 이미지 생성 | GPT 계열 이미지 생성 모델 등 | OpenAI images |
| 동영상 생성 | 주요 동영상 모델 | OpenAI images 호환 인터페이스 |
| 오디오 | 주요 음성 인식 및 음성 합성 모델 | OpenAI 호환 프로토콜 |
⚡ 스마트 라우팅: 플랫폼이 「정확한 모델 → 정확한 프로토콜 → 연관 우선순위 → 제공사 우선순위 → 헬스 점수」 순으로 자동 선로하며, 같은 모델의 여러 제공사가 서로 백업이 되어 한 번의 요청에서 최대 3개 자격 증명까지 자동 전환합니다.
📌
model에는 "모델 가격" 페이지에 표시된 모델 이름(예: claude-sonnet-5, deepseek-v4-pro)을 입력하세요. anthropic/, openai/ 같은 제공사 접두사는 붙이지 마세요.4과금 안내
- 과금 방식: 사용량 기반 과금(잔액/Credits를 실제 토큰 사용량만큼 차감)과 구독 플랜 두 가지를 지원합니다. 플랜 상세는 사용자 대시보드의 "구독" 페이지에서 확인하세요.
- 투명한 가격: 모델 가격 페이지에서 각 모델의 공식 가격과 플랫폼 가격을 실시간으로 확인할 수 있어 비용이 한눈에 들어옵니다.
- BYOK 무료: 보유한 제공사 Key로 호출하면 플랫폼 수수료가 없습니다.
- 잔액/Credits: 잔액 충전과 Credits 교환을 지원하며, Alipay로 온라인 결제할 수 있습니다.
자주 묻는 질문
연동한 뒤 모델은 어떻게 바꾸나요?
요청의 model 필드만 바꾸면 되며, 코드는 전혀 수정할 필요가 없습니다. 플랫폼 모델명과 상위 제공사의 실제 모델 ID는 시스템이 자동으로 매핑합니다.
스트리밍 출력을 지원하나요?
지원합니다. 요청에 stream: true를 추가하면 SSE 스트리밍 응답이 켜지며, OpenAI SDK의 스트리밍 방식과 호환됩니다.
API 호출이 실패하면 어떻게 하나요?
시스템이 자동으로 페일오버합니다. 그래도 실패한다면 피드백으로 알려 주세요. 영업일 기준으로 최대한 빠르게 처리하겠습니다.
호출 로그와 사용량은 어디에서 확인하나요?
사용자 대시보드에 로그인한 뒤 "호출 로그"와 "소비 내역"에서 각 호출의 모델, 토큰, 비용 내역을 확인하세요.