Kubflow API Docs

OpenAPI Schema

Import this URL into a Custom GPT action or another AI tool that supports OpenAPI actions.

https://kubflow.com/api/v1/openapi.json

Connect your AI agent

Generate images and videos in Claude Code, Cursor, Codex, and other local MCP agents. Our setup guide includes copyable instructions, a standalone connector, and a connection check. You only need a Kubflow API key and uv; no repository checkout is required.

Headers

Authorization: Bearer kf_live_YOUR_KEY
Content-Type: application/json

Alternative key headers also work: X-Kubflow-API-Key or X-API-Key.

Create Generation Body

Send category, model, prompt, and params. The model-specific fields go inside params. If category is omitted, Kubflow tries to infer it from the model ID.

{
  "category": "image",
  "model": "gpt-image-2",
  "prompt": "Describe what to generate",
  "params": {
    "aspect_ratio": "9:16",
    "resolution": "1K",
    "image_url": "https://example.com/optional-reference.png"
  }
}

Examples

curl -X POST https://kubflow.com/api/v1/generations \
  -H "Authorization: Bearer kf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "image",
    "model": "gpt-image-2",
    "prompt": "A premium product photo of an orange running shoe on a clean studio background",
    "params": {
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

curl -X POST https://kubflow.com/api/v1/generations \
  -H "Authorization: Bearer kf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "video",
    "model": "kling-3.0",
    "prompt": "A cinematic slow push-in on a glass perfume bottle with orange light reflections",
    "params": {
      "duration": 5,
      "aspect_ratio": "9:16",
      "mode": "pro",
      "sound": true
    }
  }'

curl -X POST https://kubflow.com/api/v1/generations \
  -H "Authorization: Bearer kf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "video",
    "model": "veo3",
    "prompt": "Animate the subject with a smooth camera move and realistic motion",
    "params": {
      "image_url": "https://example.com/source-image.png",
      "model": "veo3_fast",
      "resolution": "720p",
      "aspect_ratio": "9:16"
    }
  }'

Polling Status

Generations are async. Store generation_id from createGeneration and poll until status is succeeded or failed. On success, use result_url.

curl https://kubflow.com/api/v1/generations/GENERATION_ID \
  -H "Authorization: Bearer kf_live_YOUR_KEY"

{
  "generation_id": "GENERATION_ID",
  "status": "succeeded",
  "progress": 100,
  "result_url": "https://..."
}

Endpoints

Image Models

Video Models

Common Errors