Market Quickstart

Get your first ModKie API call running in minutes.

1. Browse models

Visit modkie.com/market or list via API:

curl "https://modkie.com/api/ai/models?surface=market"

Prefer ModKie hosted models for ModKie-tuned workers on the same Jobs API. Each model has a Playground at /playground/{slug} — test parameters before writing production code.

See the curated list in Market Models.

2. Create an API key

Go to Settings → API Keys and create a key (sk-...).

Never expose the key in client-side code. Optional per-key rate limits and IP whitelist are available in key settings.

3. Submit a task

Example using a ModKie-hosted image-to-video model:

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "modkie/wan-2.2-i2v",
    "input": {
      "prompt": "Gentle camera push-in, cinematic lighting",
      "image_url": "https://example.com/frame.jpg",
      "duration": 5
    }
  }'

Response:

{
  "code": 200,
  "msg": "success",
  "data": { "taskId": "task_xxx" }
}

HTTP 200 means the task was queued — not completed.

More payloads: ModKie Hosted · Examples.

4. Poll for results

curl "https://modkie.com/api/v1/jobs/recordInfo?taskId=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Poll until data.state is success or fail. On success, parse data.resultJson for output URLs.

Production tip: use webhooks instead of polling.

5. Check credits

curl "https://modkie.com/api/v1/chat/credit" \
  -H "Authorization: Bearer YOUR_API_KEY"

Where to look next

Next steps

• Getting Started — authentication, rate limits, retention, support
• Product getting started — jump links for Market and API Keys
• createTask — full request reference
• recordInfo — task states and provider routing