Replace the example API key with a workspace key and keep model-specific fields unchanged unless the table above marks them optional.
cURL
curl -X POST https://www.omixa.cloud/api/v1/videos/jobs \
-H "Authorization: Bearer omx_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1-generate-preview",
"prompt": "A smooth camera move through a neural network converging into one API endpoint.",
"video_operation": "image_to_video",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"start_frame": {
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<base64-start-frame>"
}
},
"sample_count": 1,
"wait_seconds": 3,
"poll_interval_seconds": 2
}'
JavaScript fetch
const response = await fetch('https://www.omixa.cloud/api/v1/videos/jobs', {
method: 'POST',
headers: {
'Authorization': 'Bearer omx_live_xxx',
'Content-Type': 'application/json'
},
body: "{\n \"model\": \"veo-3.1-generate-preview\",\n \"prompt\": \"A smooth camera move through a neural network converging into one API endpoint.\",\n \"video_operation\": \"image_to_video\",\n \"duration_seconds\": 8,\n \"aspect_ratio\": \"16:9\",\n \"resolution\": \"720p\",\n \"start_frame\": {\n \"type\": \"image_url\",\n \"image_url\": {\n \"url\": \"data:image/png;base64,<base64-start-frame>\"\n }\n },\n \"sample_count\": 1,\n \"wait_seconds\": 3,\n \"poll_interval_seconds\": 2\n}"
});
const data = await response.json();
Python requests
import requests
response = requests.post(
'https://www.omixa.cloud/api/v1/videos/jobs',
headers={'Authorization': 'Bearer omx_live_xxx', 'Content-Type': 'application/json'},
json={
"model": "veo-3.1-generate-preview",
"prompt": "A smooth camera move through a neural network converging into one API endpoint.",
"video_operation": "image_to_video",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"start_frame": {
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<base64-start-frame>"
}
},
"sample_count": 1,
"wait_seconds": 3,
"poll_interval_seconds": 2
}
)
print(response.json())
PHP cURL
$ch = curl_init('https://www.omixa.cloud/api/v1/videos/jobs');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer omx_live_xxx', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"model": "veo-3.1-generate-preview",
"prompt": "A smooth camera move through a neural network converging into one API endpoint.",
"video_operation": "image_to_video",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"start_frame": {
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<base64-start-frame>"
}
},
"sample_count": 1,
"wait_seconds": 3,
"poll_interval_seconds": 2
}',
CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
C# HttpClient
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "omx_live_xxx");
var json = @"{
""model"": ""veo-3.1-generate-preview"",
""prompt"": ""A smooth camera move through a neural network converging into one API endpoint."",
""video_operation"": ""image_to_video"",
""duration_seconds"": 8,
""aspect_ratio"": ""16:9"",
""resolution"": ""720p"",
""start_frame"": {
""type"": ""image_url"",
""image_url"": {
""url"": ""data:image/png;base64,<base64-start-frame>""
}
},
""sample_count"": 1,
""wait_seconds"": 3,
""poll_interval_seconds"": 2
}";
var response = await client.PostAsync("https://www.omixa.cloud/api/v1/videos/jobs", new StringContent(json, System.Text.Encoding.UTF8, "application/json"));
var body = await response.Content.ReadAsStringAsync();
Go net/http
payload := []byte(`{
"model": "veo-3.1-generate-preview",
"prompt": "A smooth camera move through a neural network converging into one API endpoint.",
"video_operation": "image_to_video",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"start_frame": {
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,<base64-start-frame>"
}
},
"sample_count": 1,
"wait_seconds": 3,
"poll_interval_seconds": 2
}`)
req, _ := http.NewRequest("POST", "https://www.omixa.cloud/api/v1/videos/jobs", bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer omx_live_xxx")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
Production checklist
Operational notes
Authenticate with `Authorization: Bearer omx_live_xxx`.
Omixa handles provider keys, routing, billing, failover, and usage recording behind this endpoint.
Google Vertex requests use active Vertex accounts configured by the admin; Omixa retries the next healthy account when a route fails before output starts.
Video generation is usually long-running. Store the returned `operation` and poll `/api/v1/videos/jobs/status` until the status is final.
