Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
Image Generation API
curl --request POST \
  --url https://kinovi.ai/api/v1/jobs/createTask
Image Generation — NanoBanana 2 (supports text + optional reference images)

Pricing

ResolutionCreditsPrice
1k15$0.075
2k15$0.075
4k25$0.125
1 credit = $0.005 (200 credits = $1)

Quick Start

# 1. Create task
curl -X POST https://kinovi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nanobanana2",
    "inputs": {
      "prompt": "A futuristic cityscape at sunset, ultra detailed",
      "imageUrls": ["https://example.com/reference.jpg"]
    }
  }'

# 2. Query status (use taskId from step 1)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://kinovi.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID"

Authentication

Get API Key: API Key Management Page
Authorization: Bearer YOUR_API_KEY

Parameters

ParameterTypeRequiredDescription
modelstringYesnanobanana2
inputsobjectYesGeneration parameters

inputs

ParameterTypeRequiredDescription
promptstringYesImage description
imageUrlsarrayNoReference image URLs for style/content guidance
negativePromptstringNoWhat to exclude from the image
aspectRatiostringNo1:1 / 3:4 (default) / 4:3 / 16:9 / 9:16
resolutionstringNo1k / 2k (default) / 4k
seednumberNoRandom seed for reproducibility

Response

Create Task Response

{
  "taskId": "task_xxxxxxxxxxxxx"
}

Query Status Response

Completed:
{
  "taskId": "task_xxx",
  "model": "nanobanana2",
  "status": "success",
  "creditsUsed": 15,
  "output": [
    { "url": "https://static.kinovi.ai/image.png", "width": 1024, "height": 1024 }
  ],
  "error": null,
  "createTime": 1709900000000,
  "completeTime": 1709900010000
}

Status Values

StatusDescription
waitingTask queued, waiting to start
generatingImage is being generated
successGeneration completed, output available
failGeneration failed, check error field

Error Codes

HTTP StatusDescription
200Success
400Invalid parameters
401Authentication failed
402Insufficient credits
404Task not found
429Rate limit / concurrency limit exceeded
500Server error