curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "xai/grok-imagine-image/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail."
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Grok (xAI)
Grok Imagine Edit
Reimagine an existing image with Grok Imagine, using text to guide changes to the subject, setting, or visual style.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "xai/grok-imagine-image/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail."
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Grok Imagine Edit
Reimagine an existing image with Grok Imagine, using text to guide changes to the subject, setting, or visual style.Available Models
- xai/grok-imagine-image/edit - Edit images using a prompt and image references.
Output Options
Image Size
size: Optional. Accepted values:1:1,2:3,3:2,9:16,16:9.
Key Features
- Edit images using a prompt and image references.
- Accepts exactly 1 image in
image_urls.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Use the input fields listed below. Supply publicly accessible HTTP(S) URLs for reference images.
Prompt
prompt: Required. Describe the requested changes. Length: 1-5,000 characters.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Use JPEG, PNG, or WebP, up to 10 MB.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and callback_url at the request root. Place generation parameters inside input.