Skip to main content
Base URL: https://platform.runblob.io

​
POST /v1/kling/o1-photo/generate

Creates an image generation task from text description using Kling O1 Photo model.
​
prompt
string
required
Text description of the image (1-2500 characters)
​
images_url
array
Array of up to 5 image URLs for reference-based generation
​
images_base64
array
Array of up to 5 base64-encoded images for reference-based generation
​
img_resolution
string
default:"2k"
Image resolution: "1k" or "2k"
​
aspect_ratio
string
default:"1:1"
Image aspect ratio. Available options:
  • "9:16" - Vertical portrait
  • "2:3" - Vertical
  • "3:4" - Vertical
  • "1:1" - Square (default)
  • "4:3" - Horizontal
  • "3:2" - Horizontal
  • "16:9" - Widescreen
  • "21:9" - Ultra-wide
​
callback_url
string
Webhook URL for completion notifications
curl -X POST https://platform.runblob.io/v1/kling/o1-photo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city with flying cars, neon lights, cyberpunk style",
    "img_resolution": "2k",
    "aspect_ratio": "16:9"
  }'

​
Response

{
  "generation_id": "photo-550e8400-e29b-41d4-a716",
  "status": "pending",
  "price": "0.0290"
}
​
generation_id
string
UUID of the generation task for status checking
​
status
string
Initial status, always "pending"
​
price
string
Amount charged in USD ($0.029 per image)
Image generation typically takes 1-2 minutes. Use the generation_id to check status or set up webhooks for notifications.Check status: GET /v1/kling/o1-photo/generations/{generation_id}

​
Generation Features

Use up to 5 input images (total from both sources):
  • images_url: Provide URLs of reference images (HTTPS)
  • images_base64: Provide base64-encoded images
  • Supports JPEG, PNG, WEBP formats
  • AI will use them as visual reference for generation
  • Maximum 10 MB per image
Choose image quality:
  • 1K: Faster generation, standard quality
  • 2K: Higher detail, recommended for most use cases
8 aspect ratio options:
  • Portrait formats: 9:16, 2:3, 3:4
  • Square: 1:1
  • Landscape formats: 4:3, 3:2, 16:9, 21:9