Qiklab API Documentation

Get your profile and balance.

Example Request

curl https://www.qiklab.com/api/v1/me \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}"

Response

{
  "username": "johndoe",
  "email": "john@example.com",
  "bio": "AI enthusiast",
  "location": "San Francisco, CA",
  "balance_cents": 999,
  "balance_dollars": "9.99",
  "created_at": "2026-03-15T12:00:00+00:00"
}

Start a generation job.

Request Body (JSON)

Example Request (t2i)

Text-to-Image generates 4 images per request. The status response will include a result_urls array with all 4 image URLs.

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2i",
    "positive_prompt": "A beautiful sunset over the ocean",
    "aspect_ratio": "3:2"
  }'

Example Request (i2i)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2i",
    "positive_prompt": "Oil painting style, warm sunset tones",
    "negative_prompt": "blurry, low quality",
    "resolution": "1k",
    "orientation": "square",
    "image": "data:image/png;base64,iVBORw0KGgo..."
  }'

Example Request (t2i_pro)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2i_pro",
    "positive_prompt": "A photorealistic portrait, studio lighting",
    "resolution": "2k",
    "aspect_ratio": "2:3"
  }'

Example Request (t2v)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "positive_prompt": "A drone shot flying over a mountain range",
    "negative_prompt": "static, jittery, low resolution",
    "resolution": "720p",
    "orientation": "horizontal",
    "duration": 5
  }'

Example Request (t2v_pro)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v_pro",
    "positive_prompt": "Cinematic slow-motion waves crashing on rocks",
    "negative_prompt": "static, low quality",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

Example Request (i2v)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "positive_prompt": "A bird takes flight from the branch",
    "negative_prompt": "static, jittery",
    "resolution": "720p",
    "duration": 5,
    "image": "data:image/png;base64,iVBORw0KGgo..."
  }'

Example Request (i2v_pro)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v_pro",
    "positive_prompt": "Camera slowly zooms in, cinematic motion",
    "negative_prompt": "static, low resolution",
    "resolution": "720p",
    "duration": 5,
    "image": "data:image/png;base64,iVBORw0KGgo..."
  }'

Example Request (i2i_pro with URLs)

The images field accepts URLs or base64 strings (with or without data:image/png;base64, prefix). Base64 images are automatically uploaded and converted server-side.

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2i_pro",
    "positive_prompt": "Recreate me perfectly in this pose",
    "resolution": "1k",
    "aspect_ratio": "3:4",
    "images": [
      "https://your-storage.com/photo1.jpg",
      "https://your-storage.com/photo2.jpg"
    ]
  }'

Example Request (i2i_pro with base64)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2i_pro",
    "positive_prompt": "Recreate me perfectly in this pose",
    "resolution": "1k",
    "aspect_ratio": "3:4",
    "images": [
      "data:image/png;base64,iVBORw0KGgo...",
      "/9j/4AAQSkZJRg..."
    ]
  }'

Both data:image/...;base64, prefixed and raw base64 strings are accepted. You can also mix URLs and base64 in the same request.

Example Request (i2i_pro_plus)

Pro+ variant uses a higher-quality model. Same parameters as i2i_pro but with mode: "i2i_pro_plus". Pricing: 1K = $0.20, 2K = $0.25, 4K = $0.30.

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2i_pro_plus",
    "positive_prompt": "Recreate me perfectly in this pose",
    "resolution": "2k",
    "aspect_ratio": "3:4",
    "images": [
      "https://your-storage.com/photo1.jpg",
      "https://your-storage.com/photo2.jpg"
    ]
  }'

Example Request (i2i_pro_plus with base64)

curl -X POST https://www.qiklab.com/api/v1/generate \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2i_pro_plus",
    "positive_prompt": "Recreate me perfectly in this pose",
    "resolution": "2k",
    "aspect_ratio": "3:4",
    "images": [
      "data:image/png;base64,iVBORw0KGgo...",
      "/9j/4AAQSkZJRg..."
    ]
  }'

Both data:image/...;base64, prefixed and raw base64 strings are accepted. You can also mix URLs and base64 in the same request.

Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "gateway_job_id": "sync-abc123",
  "status": "QUEUED",
  "mode": "t2i"
}

Check the status of a generation job.

Path Parameters

Example Request

curl https://www.qiklab.com/api/v1/status/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}"

Response (in progress)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "IN_PROGRESS"
}

Response (processing)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PROCESSING"
}

PROCESSING means the generation is done but the result is being prepared. Continue polling.

Response (completed)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "COMPLETED",
  "result_url": "https://..."
}

The result_url is a time-limited signed URL. Download the file promptly.

Response (failed)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "FAILED",
  "error": "Generation failed"
}

Check your current account balance.

Example Request

curl https://www.qiklab.com/api/v1/balance \
  -H "Authorization: Bearer qkapi_{replace-with-your-api-key-here}"

Response

{
  "balance_cents": 999,
  "balance_dollars": "9.99"
}