API 문서
이 엔드포인트에 대한 완전한 참조
기본 URL
모든 엔드포인트는 동일한 기본 URL 아래에 있습니다. 프로덕션에서는 HTTPS를 사용하세요.
https://x114.org/api/v1인증
모든 요청에는 Bearer 토큰이 필요합니다. 가입 후 설정 → API 키에서 토큰을 만드세요.
Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxx크레딧
모든 호출은 1크레딧입니다. 잔액 부족 시 402를 반환합니다. 평생 플랜에서는 크레딧이 만료되지 않습니다.
상태 코드
모든 엔드포인트에 동일한 형식이 사용됩니다.
| 코드 | 의미 |
|---|---|
| 401 | API 키가 없거나 유효하지 않습니다. |
| 402 | 크레딧이 부족합니다 — 계정에 자금을 충전하세요. |
| 429 | 요청 한도 초과 — 잠시 후 다시 시도하세요. |
| 500 | 서버 오류 — 잠시 후 다시 시도하세요. |