Documentation Index
Fetch the complete documentation index at: https://docs.eigenai.com/llms.txt
Use this file to discover all available pages before exploring further.
Video generation is an asynchronous workflow. You submit a job, poll until it completes, then download the result.
| Step | Method | Endpoint |
|---|
| Submit job | POST | /api/v1/generate |
| Poll status | GET | /api/v1/generate/status |
| Download result | GET | /api/v1/generate/result |
multipart/form-data
Parameter support can differ depending on the model used. Check the Model Library for model-specific compatibility. Open Model Library. Authentication
Send your API key in the Authorization header as a Bearer token.
Authorization: Bearer YOUR_API_KEY
Step 1 — Submit job
POST /api/v1/generate
Parameters
| Name | Type | Required | Description |
|---|
model | string | Required | The model ID (e.g. wan2p2-i2v-14b-turbo). |
prompt | string | Required | Text describing the desired video motion and animation. |
image | file | One of required | Source image to animate (multipart file upload). |
image_url | string | One of required | URL of the source image to animate. |
infer_steps | integer | Optional | Number of inference steps (default 5, range 1–20). |
seed | integer | Optional | Random seed for reproducible results. |
Response
{
"task_id": "XXXX-XXXX-XXXX-XXXX-XXXX",
"task_status": "pending"
}
Step 2 — Poll status
GET /api/v1/generate/status?jobId={task_id}&model={model}
Poll this endpoint until status is completed or failed.
Response
{
"task_id": "XXXX-XXXX-XXXX-XXXX-XXXX",
"status": "completed",
"start_time": "2024-01-01T00:00:00.000Z",
"end_time": "2024-01-01T00:01:00.000Z",
"error": null
}
| Field | Description |
|---|
status | pending, processing, completed, or failed |
error | Error message if status is failed, otherwise null |
Step 3 — Download result
GET /api/v1/generate/result?jobId={task_id}&model={model}
Returns the generated MP4 file as binary content.
Examples
Full workflow
# Step 1: Submit job
curl -X POST https://api-web.eigenai.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=wan2p2-i2v-14b-turbo" \
-F "prompt=A person waving hello" \
-F "image=@/path/to/image.jpg" \
-F "infer_steps=5" \
-F "seed=42"
# Step 2: Poll status (replace TASK_ID)
curl "https://api-web.eigenai.com/api/v1/generate/status?jobId=TASK_ID&model=wan2p2-i2v-14b-turbo" \
-H "Authorization: Bearer YOUR_API_KEY"
# Step 3: Download result
curl "https://api-web.eigenai.com/api/v1/generate/result?jobId=TASK_ID&model=wan2p2-i2v-14b-turbo" \
-H "Authorization: Bearer YOUR_API_KEY" \
-o output.mp4