Send a prompt and the inputs the v1 model needs. VidRush starts the generation and returns a link to the project in the editor, where you review, edit and export as usual.
POST
/v1/generations
200 OK
REQUEST
POST /v1/generations
{
"model": "v1",
"prompt": "The history of the Silk Road"
}
RESPONSE
{
"status": "generating",
"project_url": "https://app.vidrush.ai/…"
}
Open in editor
Prompt in, project link out
The model behind this release
Narrated videos built from real footage
Where review, edits and export happen
Every request follows the same steps, so you always know what comes back.
Google sign-in
Existing user?
No: 403, not a user
Brand Profile set?
Yes: yours · No: VidRush default
Prompt + required inputs
Start generation
Open in editor
Project link
The API does one job. Everything after the generation starts stays in the editor.
You send
A prompt
The inputs the v1 model needs
VidRush does
Checks that you’re a VidRush user
Applies your Brand Profile, or the VidRush default
Starts the generation
You get back
A link to the project in the editor
Review, edits, render and export happen in the editor. They’re outside the API.
If your account has a Brand Profile, the generation uses it. If it doesn’t, VidRush applies its default profile.
Set your Brand Profile once in VidRush
Every API generation picks it up
No profile yet: the VidRush default is used
Brand Profile set
Uses your profile
yours
No Brand Profile
Uses the VidRush default
default
FACELESS
V1
Narration and captions over real footage
Faceless · v1 model
Talking head: not in the API
The API generates faceless videos with the v1 model. Talking head videos aren’t part of the API.
Researched, scripted and narrated for you
Matched to real footage
Opens in the editor, ready to review
01
Sign in with Google.
Use the Google account you already use for VidRush. Accounts that aren’t VidRush users get a 403.
02
Send a prompt.
Add the inputs the v1 model needs. Your Brand Profile is applied, or the VidRush default if you haven’t set one.
03
Open the project link.
The response links to the project in the editor, where you review, edit, render and export.
cURL
Python
Node.js
curl -X POST "https://api.vidrush.ai/v1/generations" \
-H "Authorization: Bearer $VIDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "v1",
"prompt": "The history of the Silk Road in ten minutes"
}'
# → { "project_url": "https://app.vidrush.ai/…" }
Who can use the API?
What kind of videos can I generate?
What do I need to send?
What do I get back?
Which brand settings are used?
Can I edit, render or export through the API?
Which models are available?
Sign in with your VidRush account, send a prompt and open the project in the editor.
