Developer API Overview

Programmatically generate images, videos, music, speech, and sound effects with the Kolbo API.

The Kolbo Developer API lets you programmatically access 100+ AI models for generating images, videos, music, speech, and sound effects. Use it from any language, or integrate directly into Claude Code via our MCP server.

Quick Start

1. Get an API Key

Create a key from your dashboard or via the API:

curl -X POST https://api.kolbo.ai/api/api-keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}'

Save the fullKey from the response — it's only shown once.

2. Generate an Image

curl -X POST https://api.kolbo.ai/api/v1/generate/image \
  -H "X-API-Key: kolbo_live_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset over mountains", "aspect_ratio": "16:9"}'

Response:

{
  "success": true,
  "generation_id": "abc123",
  "type": "image",
  "poll_url": "/api/v1/generate/abc123/status",
  "poll_interval_hint": 3
}

3. Poll for Results

curl https://api.kolbo.ai/api/v1/generate/abc123/status \
  -H "X-API-Key: kolbo_live_..."

When complete:

{
  "success": true,
  "generation_id": "abc123",
  "state": "completed",
  "progress": 100,
  "result": {
    "urls": ["https://cdn.kolbo.ai/..."],
    "model": "fal-ai/flux/schnell",
    "prompt_used": "A breathtaking sunset..."
  }
}

Generation Types

Type	Endpoint	Typical Time
Chat	`POST /v1/chat`	2-30s
Image	`POST /v1/generate/image`	10-30s
Video (text)	`POST /v1/generate/video`	1-5 min
Video (from image)	`POST /v1/generate/video/from-image`	1-5 min
Music	`POST /v1/generate/music`	30s-2 min
Speech	`POST /v1/generate/speech`	5-30s
Sound Effects	`POST /v1/generate/sound`	5-30s
Creative Director	`POST /v1/generate/creative-director`	30s-3 min

Visual DNA

Create reusable visual identities for characters, products, or styles, then attach them to any generation for consistency.

Endpoint	Description
`POST /v1/visual-dna`	Create a Visual DNA from reference images
`GET /v1/visual-dna`	List your Visual DNAs
`GET /v1/visual-dna/:id`	Get Visual DNA details
`DELETE /v1/visual-dna/:id`	Delete a Visual DNA

See Visual DNA for details.

Moodboards

Discover and apply style templates (moodboards) to guide the visual direction of your generations.

Endpoint	Description
`GET /v1/moodboards`	List available moodboards (personal + presets)
`GET /v1/moodboards/:id`	Get moodboard details

Pass moodboard_id to image generation, image editing, or Creative Director requests. See Moodboards for details.

Chat

Send messages to 20+ AI models with multi-turn conversation support.

Endpoint	Description
`POST /v1/chat`	Send a chat message (requires polling)
`GET /v1/chat/conversations`	List your conversations
`GET /v1/chat/conversations/:id/messages`	Get conversation messages

See Chat for details.

Other Endpoints

Endpoint	Description
`GET /v1/models`	List available models
`GET /v1/account/credits`	Check credit balance
`GET /v1/generate/:id/status`	Poll generation status
`GET /v1/generate/creative-director/:id/status`	Poll Creative Director status (per-scene)

Authentication

All requests require the X-API-Key header with your API key:

X-API-Key: kolbo_live_...

See Authentication for details on creating and managing keys.

Claude Code Integration

Use Kolbo as native tools in Claude Code via our MCP server. See Claude Code Setup.

On this page