빠른 시작
5분이면 첫 호출까지 해볼 수 있어요.
1. API 키 받기
모두의창업 AI 솔루션을 구독한 뒤, 대시보드에서 API 키를 발급받으세요.
키는 sk-modoo-… 형태이고, 발급 시 한 번만 표시되니 안전한 곳에 보관하세요.
주의
API 키는 비밀번호와 같아요. 코드나 화면에 노출하거나 남과 공유하지 마세요.
2. 준비물
- 기본 URL —
https://modoo.devdive.me - API 키 — 위에서 발급받은
sk-modoo-….
3. 첫 요청 보내기
아래는 터미널에서 실행하는 예시예요. AI에게 "두 줄로 자기소개"를 부탁합니다.
KEY=sk-modoo-... # 발급받은 키로 바꾸세요
curl -s https://modoo.devdive.me/v1/chat/completions \
-H "Authorization: Bearer $KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"modoo-text","messages":[{"role":"user","content":"두 줄로 자기소개"}]}'
각 부분이 하는 일:
Authorization: Bearer $KEY— 내 키로 신원을 확인해요. 모든 요청에 필요합니다.model— 어떤 AI를 쓸지 고릅니다.modoo-text는 범용 기본 모델이에요(모델 참고).messages— AI에게 보내는 대화.role은user(나) 또는system(지시사항)이에요.
4. 응답 읽기
{
"id": "chatcmpl-…",
"model": "modoo-text",
"content": "안녕하세요 …",
"usage": { "input_tokens": 15, "output_tokens": 28, "total_tokens": 43 },
"cost": 0.5975
}
content— AI의 답변이에요.cost— 이번 호출로 차감된 크레딧입니다.
5. 오래 걸리는 작업 (비동기)
이미지·비디오 생성, 음성 인식처럼 시간이 걸리는 작업은 곧바로 결과를 주지 않고,
먼저 접수증(job_id) 을 돌려줘요. 그 번호로 결과가 준비됐는지 확인(폴링)합니다.
# ① 요청 → job_id 받기
curl -s https://modoo.devdive.me/v1/videos/generations \
-H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
-d '{"prompt":"석양의 해변을 걷는 강아지"}'
# { "job_id": "…", "status": "processing", "model": "modoo-video", "charge": 0.0 }
# ② 결과 확인 (준비되면 status가 succeeded로 바뀌고 결과 URL이 나와요)
curl -s https://modoo.devdive.me/v1/jobs/<job_id> -H "Authorization: Bearer $KEY"
# { "job_id": "…", "status": "succeeded", "result": { "video_url": "https://…" } }
팁
status가 processing이면 잠시 뒤 다시 ②를 호출하세요. succeeded가 되면 결과가 담겨 있어요.