Submit Seedream 5.0 Pro Image Edit Task
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedream-v5.0-pro/edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic scene with natural lighting and coherent motion",
"resolution": "1K",
"size": "1:1",
"image_urls": [
"https://cdn.vidgo.ai/examples/reference-1.jpg"
]
}
}
'import requests
url = "https://api.vidgo.ai/api/generate/submit"
payload = {
"model": "seedream-v5.0-pro/edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic scene with natural lighting and coherent motion",
"resolution": "1K",
"size": "1:1",
"image_urls": ["https://cdn.vidgo.ai/examples/reference-1.jpg"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'seedream-v5.0-pro/edit',
callback_url: 'https://your-domain.com/callback',
input: {
prompt: 'A cinematic scene with natural lighting and coherent motion',
resolution: '1K',
size: '1:1',
image_urls: ['https://cdn.vidgo.ai/examples/reference-1.jpg']
}
})
};
fetch('https://api.vidgo.ai/api/generate/submit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vidgo.ai/api/generate/submit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'seedream-v5.0-pro/edit',
'callback_url' => 'https://your-domain.com/callback',
'input' => [
'prompt' => 'A cinematic scene with natural lighting and coherent motion',
'resolution' => '1K',
'size' => '1:1',
'image_urls' => [
'https://cdn.vidgo.ai/examples/reference-1.jpg'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vidgo.ai/api/generate/submit"
payload := strings.NewReader("{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vidgo.ai/api/generate/submit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vidgo.ai/api/generate/submit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"created_time": "2023-11-07T05:31:56Z"
}
}Seedream
Seedream 5.0 Pro Image Edit
Flagship Seedream image editing model with precise prompt following and multi-image reference control
POST
/
api
/
generate
/
submit
Submit Seedream 5.0 Pro Image Edit Task
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedream-v5.0-pro/edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic scene with natural lighting and coherent motion",
"resolution": "1K",
"size": "1:1",
"image_urls": [
"https://cdn.vidgo.ai/examples/reference-1.jpg"
]
}
}
'import requests
url = "https://api.vidgo.ai/api/generate/submit"
payload = {
"model": "seedream-v5.0-pro/edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic scene with natural lighting and coherent motion",
"resolution": "1K",
"size": "1:1",
"image_urls": ["https://cdn.vidgo.ai/examples/reference-1.jpg"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'seedream-v5.0-pro/edit',
callback_url: 'https://your-domain.com/callback',
input: {
prompt: 'A cinematic scene with natural lighting and coherent motion',
resolution: '1K',
size: '1:1',
image_urls: ['https://cdn.vidgo.ai/examples/reference-1.jpg']
}
})
};
fetch('https://api.vidgo.ai/api/generate/submit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vidgo.ai/api/generate/submit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'seedream-v5.0-pro/edit',
'callback_url' => 'https://your-domain.com/callback',
'input' => [
'prompt' => 'A cinematic scene with natural lighting and coherent motion',
'resolution' => '1K',
'size' => '1:1',
'image_urls' => [
'https://cdn.vidgo.ai/examples/reference-1.jpg'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vidgo.ai/api/generate/submit"
payload := strings.NewReader("{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vidgo.ai/api/generate/submit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vidgo.ai/api/generate/submit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"seedream-v5.0-pro/edit\",\n \"callback_url\": \"https://your-domain.com/callback\",\n \"input\": {\n \"prompt\": \"A cinematic scene with natural lighting and coherent motion\",\n \"resolution\": \"1K\",\n \"size\": \"1:1\",\n \"image_urls\": [\n \"https://cdn.vidgo.ai/examples/reference-1.jpg\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"created_time": "2023-11-07T05:31:56Z"
}
}- Submit the request with
VIDGO_API_KEY. After submission, atask_idis returned. Ifcallback_urlis provided, Vidgo sends the result after the task finishes or fails. - You can always retrieve the result through the unified Query Task Status endpoint.
Seedream 5.0 Pro Image Edit
Seedream 5.0 Pro Edit applies controlled changes using up to ten reference images while preserving requested visual details.Available Models
- seedream-v5.0-pro/edit - Image editing with multi-image reference support
Size Parameter
input.size controls the output aspect ratio and defaults to 1:1:
- Ratio presets:
1:1,4:3,3:4,16:9,9:16,2:3,3:2,21:9
Resolution Parameter
input.resolution controls output resolution and defaults to 1K:
- Resolution presets:
1K,2K
Pricing
Each request generates one image and uses the current Seedream 5.0 Pro model price.How to Call
Use the unified submit endpoint:POST /api/generate/submit
{
"model": "seedream-v5.0-pro/edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic scene with natural lighting and coherent motion",
"resolution": "1K",
"size": "1:1",
"image_urls": [
"https://cdn.vidgo.ai/examples/reference-1.jpg"
]
}
}
Authorizations
Use Authorization: Bearer VIDGO_API_KEY.
Body
application/json
⌘I