Submit a HiDream-O1-Video-1.0 Generation Task
1. Endpoint
/api/maas/gw/v1/videos/generations
2. Method
POST
3. Request Parameters
Header
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer API key, for example Bearer sk-xxxxxxxx |
| Content-Type | string | Yes | application/json |
Body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| model_id | string | Yes | - | Fixed value: HiDream-O1-Video-1.0 |
| image | string | Yes | - | Reference image provided as a publicly accessible URL or Base64-encoded data without the Data URL prefix. File size must be between 40 KB and 20 MB |
| prompt | string | No | "" |
Positive prompt |
| force_10s | boolean | No | false |
Whether to force the generated video to have a duration of 10 seconds |
| request_id | string | No | "" |
Client-defined request ID |
4. Request Example
curl --request POST 'https://hiharness.hidreamai.com/api/maas/gw/v1/videos/generations' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model_id": "HiDream-O1-Video-1.0",
"image": "https://example.com/input.png",
"prompt": "The subject turns toward the camera, with gentle cinematic motion",
"negative_prompt": "blur, distortion",
"request_id": "my-video-task-001"
}'
5. Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | Status code. 0 indicates a successful request |
| message | string | Response message |
| request_id | string | Unique request identifier |
| result | object | Submission result |
| result.task_id | string | Task ID used to query the generation result |
6. Response Example
{
"code": 0,
"message": "Success",
"request_id": "8f66fdf3-7c22-4f85-94d1-6b26170f6789",
"result": {
"task_id": "7aa15e3d-dcd6-4c27-9378-87ec97b2fbce"
}
}