Retrieve an image generation task

GET

images

generations

{task_id}

cURL

curl "https://api.runbridge.ai/v1/images/generations/<task_id>" \
  -H "Authorization: Bearer $RUNBRIDGE_API_KEY"

import os
import time
import requests

task_id = "<task_id>"
headers = {"Authorization": "Bearer " + os.environ["RUNBRIDGE_API_KEY"]}

while True:
    task = requests.get(
        f"https://api.runbridge.ai/v1/images/generations/{task_id}",
        headers=headers,
    ).json()
    status = task["data"]["status"]
    print(status)
    if status in ("success", "failure"):
        break
    time.sleep(3)

if status == "success":
    print(task["data"]["data"][0].keys())

const taskId = "<task_id>";
const headers = { Authorization: `Bearer ${process.env.RUNBRIDGE_API_KEY}` };

let task;
while (true) {
  const response = await fetch(
    `https://api.runbridge.ai/v1/images/generations/${taskId}`,
    { headers },
  );
  task = await response.json();
  const status = task.data.status;
  console.log(status);
  if (status === "success" || status === "failure") break;
  await new Promise((resolve) => setTimeout(resolve, 3000));
}

if (task.data.status === "success") {
  console.log(Object.keys(task.data.data[0]));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.runbridge.ai/v1/images/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.runbridge.ai/v1/images/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.runbridge.ai/v1/images/generations/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "success",
  "data": {
    "task_id": "<task_id>",
    "status": "pending",
    "data": []
  }
}

Use this endpoint after you create an image with POST /v1/images/generations and async: true. The create request returns data.task_id, and this endpoint returns the task state plus final image data when the task succeeds.

Poll an image task

Create the task

Send POST /v1/images/generations with async: true, then store data.task_id.

Poll the task

Call this endpoint with the stored task ID until data.status is success or failure.

Read the image data

When data.status is success, read the first item in data.data. Decode b64_json to save image bytes, or download url when it is present.

Status values

pending: The task is queued or generating.
success: The task finished and data.data contains the generated image data.
failure: The task failed. Check data.fail_reason when it is returned.

Authorizations

Authorization

string

header

required

Bearer token authentication. Use your RunBridge AI key.

Path Parameters

task_id

string

required

Task ID returned in data.task_id by the async create request.

Response

200 - application/json

Current image generation task state.

code

string

required

Request status code. Successful task lookups return success.

Example:

"success"

data

object

required

Show child attributes

message

string

Optional status message.

Last modified on October 9, 2026

cURL

curl "https://api.runbridge.ai/v1/images/generations/<task_id>" \
  -H "Authorization: Bearer $RUNBRIDGE_API_KEY"

import os
import time
import requests

task_id = "<task_id>"
headers = {"Authorization": "Bearer " + os.environ["RUNBRIDGE_API_KEY"]}

while True:
    task = requests.get(
        f"https://api.runbridge.ai/v1/images/generations/{task_id}",
        headers=headers,
    ).json()
    status = task["data"]["status"]
    print(status)
    if status in ("success", "failure"):
        break
    time.sleep(3)

if status == "success":
    print(task["data"]["data"][0].keys())

const taskId = "<task_id>";
const headers = { Authorization: `Bearer ${process.env.RUNBRIDGE_API_KEY}` };

let task;
while (true) {
  const response = await fetch(
    `https://api.runbridge.ai/v1/images/generations/${taskId}`,
    { headers },
  );
  task = await response.json();
  const status = task.data.status;
  console.log(status);
  if (status === "success" || status === "failure") break;
  await new Promise((resolve) => setTimeout(resolve, 3000));
}

if (task.data.status === "success") {
  console.log(Object.keys(task.data.data[0]));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.runbridge.ai/v1/images/generations/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.runbridge.ai/v1/images/generations/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.runbridge.ai/v1/images/generations/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "success",
  "data": {
    "task_id": "<task_id>",
    "status": "pending",
    "data": []
  }
}

​Poll an image task

​Status values

Authorizations

Path Parameters

Response

Poll an image task

Status values