API reference
Video
Video generation, run as a job.
On this page
POST/v1/videos/generations
Starts a clip and answers 202 with its id.
Auth: API key, or pay per request under https://api.usdf.fi/x402
| Name | Type | Required | Description |
|---|---|---|---|
model | string | Yes | A video model id. |
prompt | string | Yes | What the clip shows. |
seconds | integer | No | The clip length. |
POST /v1/videos/generations
curl
curl -X POST https://api.usdf.fi/v1/videos/generations \
-H "Authorization: Bearer $USDF_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<video model>",
"prompt": "A paper boat drifting down a river, slow pan"
}'GET/v1/videos/{id}
The job's status.
Auth: API key: Authorization: Bearer sk_…
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Path. The video id. |
GET /v1/videos/{id}
curl
curl https://api.usdf.fi/v1/videos/{id} \
-H "Authorization: Bearer $USDF_API_KEY"GET/v1/videos/{id}/content
The finished clip.
Auth: API key: Authorization: Bearer sk_…
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Path. The video id. |
GET /v1/videos/{id}/content
curl
curl https://api.usdf.fi/v1/videos/{id}/content \
-H "Authorization: Bearer $USDF_API_KEY"Foundry documentation