curl --request POST \
--url https://api.voyager.so/v1/machines/estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"frames": 5000000,
"seconds": 1,
"width": 8200,
"height": 8200
}
'import requests
url = "https://api.voyager.so/v1/machines/estimate"
payload = {
"frames": 5000000,
"seconds": 1,
"width": 8200,
"height": 8200
}
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({frames: 5000000, seconds: 1, width: 8200, height: 8200})
};
fetch('https://api.voyager.so/v1/machines/estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"gpu": "<string>",
"preset": "<string>",
"frames": 123,
"width": 123,
"height": 123,
"profile": "<string>",
"seconds_low": 123,
"seconds_typical": 123,
"seconds_high": 123,
"seconds_per_frame": 123,
"setup_seconds": 123,
"usd_per_minute": 123,
"credits_per_minute": 123,
"usd_low": 123,
"usd_high": 123,
"credits_low": 123,
"credits_high": 123,
"basis": "default",
"samples": 123,
"note": "<string>",
"alternatives": [
{
"preset": "<string>",
"gpu": "<string>",
"gpus": 123,
"seconds_low": 123,
"seconds_typical": 123,
"seconds_high": 123,
"usd_low": 123,
"usd_high": 123,
"credits_low": 123,
"credits_high": 123,
"speedup": 123
}
],
"recommendation": {
"preset": "<string>",
"reason": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}Estimate Render
Roughly how long and how much a Vork render takes. With from_job or sample it scales this scene’s own
measured speed (scenes vary a lot); otherwise it uses recent real renders on that GPU, or built-in typical speeds
until there are enough. alternatives gives the same job on the other Vork presets your plan runs, and
recommendation names one that saves real wall time (a long render on render-2x or render-4x).
curl --request POST \
--url https://api.voyager.so/v1/machines/estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"frames": 5000000,
"seconds": 1,
"width": 8200,
"height": 8200
}
'import requests
url = "https://api.voyager.so/v1/machines/estimate"
payload = {
"frames": 5000000,
"seconds": 1,
"width": 8200,
"height": 8200
}
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({frames: 5000000, seconds: 1, width: 8200, height: 8200})
};
fetch('https://api.voyager.so/v1/machines/estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"gpu": "<string>",
"preset": "<string>",
"frames": 123,
"width": 123,
"height": 123,
"profile": "<string>",
"seconds_low": 123,
"seconds_typical": 123,
"seconds_high": 123,
"seconds_per_frame": 123,
"setup_seconds": 123,
"usd_per_minute": 123,
"credits_per_minute": 123,
"usd_low": 123,
"usd_high": 123,
"credits_low": 123,
"credits_high": 123,
"basis": "default",
"samples": 123,
"note": "<string>",
"alternatives": [
{
"preset": "<string>",
"gpu": "<string>",
"gpus": 123,
"seconds_low": 123,
"seconds_typical": 123,
"seconds_high": 123,
"usd_low": 123,
"usd_high": 123,
"credits_low": 123,
"credits_high": 123,
"speedup": 123
}
],
"recommendation": {
"preset": "<string>",
"reason": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}{
"error": {
"type": "invalid_request",
"code": "<string>",
"message": "<string>",
"doc_url": "<string>",
"request_id": "<string>",
"retryable": true,
"retry_after_ms": 123,
"param": "<string>",
"loc": [
"<string>"
],
"details": {}
}
}Authorizations
API key from Settings > Developer > REST API
Body
The preset to estimate for (render, the default).
Or a GPU model, e.g. L4.
Frames to render (1 for a still). Or seconds and fps.
1 <= x <= 10000000Video length in seconds (with fps).
x > 0Frames per second (with seconds).
0 < x <= 1000720p, 1080p, 1440p, 4k (or 480p, WxH). Default 1920x1080.
Or a width in pixels (with height).
16 <= x <= 16384Or a height in pixels (with width).
16 <= x <= 16384The Vork render profile.
std/previs, std/draft, std/final, std/path Add the one-time vork setup of a new machine. Default: true, unless the machine (machine_id, or from_job's) already ran vork setup.
A machine of yours: its GPU and image.
A finished vork render job of this scene on one of your machines: scale its measured speed (basis this_scene). Its machine's GPU is used unless you name one.
Or a render of this scene you timed yourself (basis this_scene).
Show child attributes
Show child attributes
Response
Successful Response
The GPU the estimate is for.
Its preset, when it matches one.
Frames estimated.
Width in pixels.
Height in pixels.
The Vork render profile.
Fast end of the whole job, setup included when asked.
Typical whole job, setup included when asked.
Slow end, including up to a couple of minutes of first-use scene compilation.
Typical seconds per frame at this size and profile.
Typical one-time vork setup seconds included (0 when not).
The GPU's live price per minute (null when not offered now).
The same in credits.
Cost at seconds_low.
Cost at seconds_high.
Credits at seconds_low.
Credits at seconds_high.
this_scene: scaled from a render of this scene (from_job or sample); measured: from recent real Vork renders on this GPU; default: built-in typical speeds.
default, measured, this_scene Renders the estimate is based on (0 for default).
What to tell the user, for agents.
The same job on the other Vork presets your plan runs (render-lite, render, render-2x, render-4x), frames split across a multi-GPU machine's GPUs.
Show child attributes
Show child attributes
A preset that saves at least 30% of the wall time (and at least a minute) for at most 1.5x the total cost, the extra cost in its reason (null when none does).
Show child attributes
Show child attributes