GenFlare 2.0 API - AI Video Generation APIs
by Baidu
GenFlare 2.0 API, developers can bring images to life with realistic motion, creating engaging video content without traditional video production. The API excels at image-to-video transformation, adding natural movement and animation to still photographs for social media, marketing, and creative applications.

Models Version
Get $5 Free Credit on First Payment
No strings attached — add funds and get $5 bonus instantly
Genflare v2 Image to Video API Documentation
https://gateway.pixazo.ai/baidu-genflare-2-0-api/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Generate Image To Video - Baidu GenFlare 2.0 APIs
Request Code
POST https://gateway.pixazo.ai/baidu-genflare-2-0-api/v1/generateImageToVideo2-5Request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"img_url": "https://example.com/images/cat.png",
"prompt": "A cat running on the grass",
"resolution": "480P",
"duration": 5,
"audio": false,
"prompt_extend": true,
"watermark": false
}
import requests
url = "https://gateway.pixazo.ai/baidu-genflare-2-0-api/v1/generateImageToVideo2-5Request"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"img_url": "https://example.com/images/cat.png",
"prompt": "A cat running on the grass",
"resolution": "480P",
"duration": 5,
"audio": False,
"prompt_extend": True,
"watermark": False
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/baidu-genflare-2-0-api/v1/generateImageToVideo2-5Request';
const data = {
img_url: 'https://example.com/images/cat.png',
prompt: 'A cat running on the grass',
resolution: '480P',
duration: 5,
audio: false,
prompt_extend: true,
watermark: false
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/baidu-genflare-2-0-api/v1/generateImageToVideo2-5Request" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"img_url": "https://example.com/images/cat.png",
"prompt": "A cat running on the grass",
"resolution": "480P",
"duration": 5,
"audio": false,
"prompt_extend": true,
"watermark": false
}'
Output
{
"request_id": "baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Generate Image To Video
| Parameter | Required | Type | Description |
|---|---|---|---|
| img_url | Yes | string | URL to the first-frame image. Supports public URLs, Base64 encoding, or local file paths. |
| prompt | No | string | Text description of the video to generate. Supports English and Chinese. |
| negative_prompt | No | string | Default: null. Elements to exclude from the video. |
| audio_url | No | string | URL to custom audio file (overrides audio parameter). Takes priority over `audio` setting. |
| resolution | No | string | Default: "480P". Available resolutions: "480P", "720P", "1080P". Internally converted to size format. |
| duration | No | integer | Default: 5. Video length in seconds. Available values: 5, 10 |
| audio | No | boolean | Default: false. Audio behavior: false (silent), true (auto-generate audio) |
| prompt_extend | No | boolean | Default: true. Enable intelligent prompt rewriting |
| watermark | No | boolean | Default: false. Add watermark to video |
| seed | No | integer | Random seed for reproducible results |
Example Request
{
"img_url": "https://example.com/images/cat.png",
"prompt": "A cat running on the grass",
"resolution": "480P",
"duration": 5,
"audio": false,
"prompt_extend": true,
"watermark": false
}
Response
{
"request_id": "baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'baidu-genflare-2-0-api' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "baidu-genflare-2-0-api",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "baidu-genflare-2-0-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "baidu-genflare-2-0-api",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/baidu-genflare-2-0-api_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Genflare v2 Image to Video API Pricing
No data available
Could not load current pricing