Theme
Query Task
GET
https://www.kkiai.com/v1/video/query
Given a prompt, the model will return one or more predicted completions, and can also return the probability of alternative tokens at each position.
Create a completion for the provided prompt and parameters
Request Parameters
Authorization
Add the Authorization parameter in the Header, with the value being the Token concatenated after Bearer
Example: Authorization: Bearer ********************
Query Parameters
| Parameter Name | Type | Required | Description | Example |
|---|---|---|---|---|
id | string | Required | veo3.1-fast:1770350082-trii1OXZc3 |
Header Parameters
| Parameter Name | Type | Required | Description | Example |
|---|---|---|---|---|
Content-Type | string | Required | application/json | |
Accept | string | Required | application/json | |
Authorization | string | Optional | Bearer {{YOUR_API_KEY}} | |
X-Forwarded-Host | string | Optional | localhost:5173 |
cURL Example
bash
curl --location --request GET 'https://www.kkiai.com/v1/video/query?id=veo3.1-fast:1770350082-trii1OXZc3' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'Response
🟢 200 Success
Response Body
| Parameter Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | |
status | string | Required | |
video_url | null | Required | |
enhanced_prompt | string | Required | |
status_update_time | integer | Required |
Response Example
json
{
"id": "veo3.1-fast:1770350082-trii1OXZc3",
"detail": {
"id": "veo3.1-fast:1770350082-trii1OXZc3",
"req": {
"model": "veo3.1-fast",
"images": [
"https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png"
],
"prompt": "make animate",
"aspect_ratio": "16:9",
"enhance_prompt": true,
"enable_upsample": true
},
"images": [
{
"url": "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png",
"status": "completed",
"mediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM"
}
],
"status": "completed",
"running": false,
"video_url": "https://pro.filesystem.site/cdn/20260206/9ddbd3bdc67f75a02f766363ebf8eb.mp4",
"created_at": 1770350082099,
"error_sleep": 5000,
"max_retries": 3,
"retry_count": 3,
"completed_at": 1770350328994,
"error_message": "[403] Request failed with status code 403 | Message: reCAPTCHA evaluation failed | Code: 403 | Status: PERMISSION_DENIED | Reason: PUBLIC_ERROR_SOMETHING_WENT_WRONG | Type: type.googleapis.com/google.rpc.ErrorInfo | URL: /v1/video:batchAsyncGenerateVideoStartImage",
"video_media_id": "CAUSJDU1YzFjNTliLWYxNzctNGYwYy04YTJkLTI3MGFkMWE4YjkyMxokMTZjYjk1NzUtYWY4Yy00MzQzLWI4NjMtNGQ5YWFiZTZmNzMzIgNDQUUqJGQxZjBhOGExLTUxYjYtNDk5Yy04YWJlLWFhZTU0YzZiMjIxZQ",
"enhanced_prompt": "Create a vibrant and whimsical animation that features a joyful scene of colorful animals playing together in a sunny meadow, surrounded by blooming flowers and butterflies fluttering by.",
"upsample_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL",
"startImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM",
"status_update_time": 1770350329098,
"upsample_video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4",
"video_generation_id": "608c00e8de85d8856554201ae115b7c2",
"veo3StartImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM",
"needs_safe_enhancement": true,
"upsample_generation_id": "d1f0a8a1-51b6-499c-8abe-aae54c6b221e_upsampled",
"video_generation_error": "your request contains unsafe prompt or images, such as porn, violence, minors etc., has been rejected by google, please change your prompt or images and try again",
"video_generation_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL"
},
"status": "completed",
"video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4",
"status_update_time": 1770350329098
}