Payload Examples

All Market generation models share one async Jobs pattern. This page shows minimal, copy-paste payloads. Parameter details live on each Market model page and Playground — not here.

Prefer ModKie-hosted workers first: ModKie Hosted Models.

Universal flow

Authorization: Bearer YOUR_API_KEY
POST /api/v1/jobs/createTask → { data: { taskId } } (HTTP 200 = queued)
GET /api/v1/jobs/recordInfo?taskId=… until state is success or fail
Or use webhooks / per-task callBackUrl

Credits are deducted only on success. Failed tasks are not charged.

# Poll template (every example below)
curl "https://modkie.com/api/v1/jobs/recordInfo?taskId=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Video

Veo 3.1

Catalog: google/veo-3-1 · Playground: /playground/veo-3-1

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3-1",
    "input": {
      "prompt": "Ocean waves at golden hour, cinematic drone shot",
      "aspect_ratio": "16:9",
      "duration": "5"
    }
  }'

Kling 3.0

Catalog: kling/kling-3-0 · Playground: /playground/kling-3-0

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling/kling-3-0",
    "input": {
      "prompt": "A dancer in neon rain",
      "aspect_ratio": "9:16"
    }
  }'

Runway Gen-4 Turbo

Catalog: runway/gen4-turbo · Playground: /playground/runway-api

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway/gen4-turbo",
    "input": {
      "prompt": "A majestic eagle soaring through mountain clouds at sunset",
      "duration": 5,
      "quality": "720p",
      "aspectRatio": "16:9"
    }
  }'

Seedance 2 Fast

Catalog: bytedance/seedance-2-fast · Playground: /playground/seedance

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-fast",
    "input": {
      "prompt": "City street at night, neon reflections on wet pavement",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5
    }
  }'

Seedance 2 Mini

Catalog: bytedance/seedance-2-mini · Playground: /playground/seedance-2-mini

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-mini",
    "input": {
      "prompt": "Cinematic kitchen baking scene, hands kneading dough",
      "first_frame_url": "https://example.com/first.jpg",
      "last_frame_url": "https://example.com/last.jpg",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 15
    }
  }'

Wan 2.7

Catalog: wan/2-7-text-to-video · Playground: /playground/wan-video

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan/2-7-text-to-video",
    "input": {
      "prompt": "A cat walking through a sunlit garden, shallow depth of field",
      "aspect_ratio": "16:9",
      "resolution": "720p"
    }
  }'

Image

Nano Banana 2

Catalog: nano-banana-2 · Playground: /playground/nano-banana-2

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "input": {
      "prompt": "A studio product photo of wireless headphones on marble",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

Grok Imagine 1.5

Catalog: grok/imagine-1-5 · Playground: /playground/grok-imagine

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok/imagine-1-5",
    "input": {
      "prompt": "Photorealistic portrait, soft natural lighting, shallow depth of field"
    }
  }'

GPT Image 2

Catalog: openai/gpt-image-2 · Playground: /playground/gpt-image

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "input": {
      "prompt": "Minimal tech logo, flat vector style, blue gradient",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

Audio

Suno V4

Catalog: suno/v4 · Playground: /playground/suno-api

curl -X POST "https://modkie.com/api/v1/jobs/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v4",
    "input": {
      "prompt": "Upbeat electronic track with synth melody, 120 BPM",
      "title": "Neon Drive",
      "tags": "electronic, energetic"
    }
  }'

Chat (not Jobs)

Claude and other chat models use the OpenAI-compatible gateway — see Chat.
Qwythos 9B: ModKie Hosted Models § Qwythos.

On this page