개발자
어시스턴트를 앱, MCP 클라이언트, 웹사이트로 가져가세요. 어디서든 비용은 채팅과 같습니다.
3단계로 시작하기
- 1
키 만들기
프로필 → 개발자에서 API 키를 받으세요. 키는 계정으로 동작합니다.
API 키 관리 → - 2
여기서 시험하기
아래 플레이그라운드에서 엔드포인트를 고르고 키를 붙여 넣은 뒤 테스트를 누르세요.
플레이그라운드 → - 3
코드에 추가하기
준비된 cURL, JavaScript, Python 예제를 복사하세요. MCP와 위젯은 탭에 있습니다.
문서 →
플레이그라운드
엔드포인트를 고르고 매개변수를 채운 뒤 테스트를 누르세요. 실제 요청이며 코드는 그대로 복사할 수 있습니다.
POST/api/v1/conversations
대화 시작: { text, locale?, model?, tools? } — tools로 이미지, 동영상, 음악, 음성을 만드세요.
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"ko"}'응답 본문
응답이 여기에 표시됩니다.
문서
인증
프로필 → 개발자에서 API 키를 만들고 모든 요청의 헤더로 보내세요. 키는 계정으로 동작하니 공유하지 마세요.
Authorization: Bearer sk_...REST API
JSON 입력, JSON 출력. 답변은 백그라운드에서 작성됩니다: 메시지를 보낸 뒤 `pending`이 false가 될 때까지 대화를 읽으세요.
POST/api/v1/conversations대화 시작: { text, locale?, model?, tools? } — tools로 이미지, 동영상, 음악, 음성을 만드세요.POST/api/v1/conversations/{id}메시지 추가: { text, locale?, model?, tools? }GET/api/v1/conversations/{id}최근 메시지와 `pending` 상태GET/api/v1/conversations최근 대화GET/api/v1/credits남은 크레딧GET/api/v1/tools사용 가능한 도구와 비용
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "Merhaba", "locale": "ko", "thinking": false}'
# → {"id": "…"} — 몇 초 뒤 답변을 읽으세요
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."선택 필드: thinking(false → 추론 끄기, 더 빠르고 저렴한 답변), instructions(이번 턴의 시스템 지시, 최대 20,000자, 매 요청마다 전송), private(true → 요금제가 비공개 채팅을 허용하지 않으면 402 needs-private). 읽은 메시지의 reasoning 필드에 모델의 추론이 담깁니다.
오류: 401 잘못된 키 · 402 크레딧 부족 또는 Pro 필요 · 409 이전 답변 진행 중 또는 동의 필요 · 429 속도 제한.