Documentation Index
Fetch the complete documentation index at: https://seedance2-pro.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Image Generation — NanoBanana 2 (supports text + optional reference images)
Pricing
| Resolution | Credits | Price |
|---|
| 1k | 15 | $0.075 |
| 2k | 15 | $0.075 |
| 4k | 25 | $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
| Parameter | Type | Required | Description |
|---|
| model | string | Yes | nanobanana2 |
| inputs | object | Yes | Generation parameters |
| Parameter | Type | Required | Description |
|---|
| prompt | string | Yes | Image description |
| imageUrls | array | No | Reference image URLs for style/content guidance |
| negativePrompt | string | No | What to exclude from the image |
| aspectRatio | string | No | 1:1 / 3:4 (default) / 4:3 / 16:9 / 9:16 |
| resolution | string | No | 1k / 2k (default) / 4k |
| seed | number | No | Random 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
| Status | Description |
|---|
waiting | Task queued, waiting to start |
generating | Image is being generated |
success | Generation completed, output available |
fail | Generation failed, check error field |
Error Codes
| HTTP Status | Description |
|---|
| 200 | Success |
| 400 | Invalid parameters |
| 401 | Authentication failed |
| 402 | Insufficient credits |
| 404 | Task not found |
| 429 | Rate limit / concurrency limit exceeded |
| 500 | Server error |