Skip to main content

Quickstart

You can make your first call in about 5 minutes.

1. Get an API key​

Subscribe to the 데브다이브-모두의창업 AI solution, then issue an API key from the dashboard. Keys look like sk-modoo-…, and they're shown only once when issued, so keep yours somewhere safe.

caution

An API key is like a password. Don't expose it in your code or on screen, and don't share it with anyone.

2. What you'll need​

  • Base URL — https://modoo.devdive.me
  • API key — the sk-modoo-… you issued above.

3. Send your first request​

Here's an example you run in your terminal. It asks the AI for "a two-line self-introduction."

KEY=sk-modoo-... # replace with your issued key

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":"Introduce yourself in two lines"}]}'

What each part does:

  • Authorization: Bearer $KEY — verifies your identity with your key. Required on every request.
  • model — chooses which AI to use. modoo-text is the general-purpose default model (see Models).
  • messages — the conversation you send to the AI. role is either user (you) or system (instructions).

4. Read the response​

{
  "id": "chatcmpl-…",
  "model": "modoo-text",
  "content": "Hello …",
  "usage": { "input_tokens": 15, "output_tokens": 28, "total_tokens": 43 },
  "cost": 0.5975
}
  • content — the AI's answer.
  • cost — the credits deducted by this call.

5. Long-running tasks (asynchronous)​

Time-consuming tasks like image and video generation or speech recognition don't return a result right away. Instead, they first return a receipt (job_id). You then use that number to check whether the result is ready (polling).

# ① Send the request → get a job_id
curl -s https://modoo.devdive.me/v1/videos/generations \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{"prompt":"A dog walking on the beach at sunset"}'
# { "job_id": "…", "status": "processing", "model": "modoo-video", "charge": 0.0 }

# ② Check the result (once ready, status changes to succeeded and a result URL appears)
curl -s https://modoo.devdive.me/v1/jobs/<job_id> -H "Authorization: Bearer $KEY"
# { "job_id": "…", "status": "succeeded", "result": { "video_url": "https://…" } }
tip

If status is processing, call ② again a little later. Once it becomes succeeded, the result is included.

Next steps​