첫 번째 API 요청 — curl로 OpenAI API 키 테스트하기
APIMaster.ai에서 발급받은 OpenAI 호환 키로 첫 API 요청을 보내는 방법. curl로 테스트하여 키가 정상 작동하는지 확인하고, 채팅 완료 엔드포인트 응답을 검증합니다.
첫 번째 요청
API 키를 보유한 후 다음을 실행하세요:
Chat Completions
curl -s "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Reply with exactly: ok"}],
"max_tokens": 32
}'
성공적인 응답에는 choices[0].message.content가 포함됩니다.
모델 목록
curl -s "https://apimaster.ai/v1/models" \
-H "Authorization: Bearer YOUR_API_KEY"
모델 ID는 지원되는 모델 목록 및 계정과 일치해야 합니다.
일반적인 오류
| 상태 | 예상 원인 |
|---|---|
401 |
유효하지 않거나 해지된 키 |
403 |
잔액 또는 권한 문제 |
404 |
잘못된 모델 ID 또는 계정에 활성화되지 않음 |
429 |
요청 제한 — 백오프 후 재시도 |
| 타임아웃 | 네트워크 또는 느린 업스트림 — 클라이언트 타임아웃 증가 |