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-quality/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1K"
}
}
'
{
"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 Image Quality Edit
Develop new image variations with Grok Imagine Image Quality, combining text instructions and visual references in output up to 2K.
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-quality/edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1K"
}
}
'
{
"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 Image Quality Edit
Develop new image variations with Grok Imagine Image Quality, combining text instructions and visual references in output up to 2K.Available Models
- xai/grok-imagine-image-quality/edit - Edit images using a prompt and image references.
Output Options
Aspect Ratio
aspect_ratio: Optional. Accepted values:1:1,2:3,3:2,9:16,16:9. Default:1:1.
Resolution
resolution: Optional. Accepted values:1K,2K. Default:1K.
Image Count
n: Optional. Number of images to generate. Integer, at least1. Default:1. No maximum is documented upstream; fractional numbers, strings, and booleans are rejected.
Key Features
- Edit images using a prompt and image references.
- Accepts 1-3 images in
image_urls. - Choose from
1K,2Koutput resolutions. - Control the number of output images with
n.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
Prompt
prompt: Required. Describe the requested changes. Minimum length: 1 character.- The value must be a string and must not be blank. No maximum prompt length is documented upstream.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply 1-3 items. Each item must be an HTTP(S) URL.
Billing Factors
Billing depends on output resolution (resolution) and output image count (n). Reference image count (image_urls) adds a separate input charge once per request; this charge is not multiplied by n.
Credits are deducted on submission and refunded if the task fails.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.