개발자
어시스턴트를 앱, MCP 클라이언트, 웹사이트로 가져가세요. 어디서든 비용은 채팅과 같습니다.
3단계로 시작하기
- 1
키 만들기
프로필 → 개발자에서 API 키를 받으세요. 키는 계정으로 동작합니다.
API 키 관리 → - 2
여기서 시험하기
아래 플레이그라운드에서 엔드포인트를 고르고 키를 붙여 넣은 뒤 테스트를 누르세요.
플레이그라운드 → - 3
코드에 추가하기
준비된 cURL, JavaScript, Python 예제를 복사하세요. MCP와 위젯은 탭에 있습니다.
문서 →
플레이그라운드
엔드포인트를 고르고 매개변수를 채운 뒤 테스트를 누르세요. 실제 요청이며 코드는 그대로 복사할 수 있습니다.
POST/api/v1/conversations
대화 시작: { text, locale?, model?, tools? } — tools로 이미지, 동영상, 음악, 음성을 만드세요.
실제 요청입니다: 메시지 비용이 크레딧에서 차감됩니다. (크레딧 1개)
코드
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"ko"}'응답 본문
응답이 여기에 표시됩니다.
문서
멀티미디어
채팅의 도구를 API에서도 쓸 수 있습니다: 이미지, 동영상, 음악, 음성, 웹 검색. tools 필드로 추가하면 생성된 파일이 공개 URL과 함께 media 배열로 돌아옵니다.
| 작업 | API 이름 | 비용 |
|---|---|---|
| 웹에서 검색 | web_search | 크레딧 1개 |
| 이미지 만들기 | generate_image | 크레딧 3개 |
| 동영상 만들기 | generate_video | 초당 크레딧 10개 |
| 음악 만들기 | generate_music | 크레딧 5개 |
| 텍스트 읽어주기 | speak_text | 크레딧 1개 |
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "a red fox in the snow, watercolor", "tools": ["generate_image"]}'
# GET /api/v1/conversations/{id}
{
"pending": false,
"generating": false,
"messages": [
{ "role": "assistant", "content": "…", "media": [
{ "name": "image.png", "type": "image/png", "url": "https://…/image.png" }
] }
]
}이미지는 답변과 함께 옵니다. 동영상과 음악은 백그라운드에서 생성되므로 generating이 false가 될 때까지 대화를 읽으세요. 업로드가 필요한 도구는 API에 없습니다.