Get a Flow Output by ID

Download a specific generated output asset (e.g., 3D model) by its asset ID.

Requirements: Flow must be in one of the following terminal states:

  • completed: Flow finished successfully
  • aborted: Flow was manually aborted
  • failed: Flow encountered an error

Response Format: The response contains only the data field with the complete base64-encoded file as data URI.

Example Response:

{
  "data": "data:model/gltf-binary;base64,Z2xURg..."
}

Use Cases:

  • Download a specific 3D model file
  • Retrieve individual outputs when multiple assets were generated

Workflow:

  1. Get the asset_id from GET /flows/{'{'}flow_id{'}'}/outputs
  2. Use this endpoint to download the specific file
  3. Decode the base64 data and save as GLB file

Note: Unlike GET /flows/{'{'}flow_id{'}'}/outputs, this endpoint always returns the full file data without requiring a query parameter.

This endpoint allows you to get a specific output asset.

Endpoint

GET https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}

Parameters

flow_id (required)

  • Location: path
  • Type: string

asset_id (required)

  • Location: path
  • Type: string

Responses

200

Successful Response

422

Validation Error

Code Examples

Copy and run these examples in your terminal or code editor. Make sure to replace YOUR_TOKEN with your actual authentication token.

curl -X GET "https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

wget --header="Authorization: Bearer YOUR_TOKEN" \
  "https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}" -O -

import requests

url = "https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}"
headers = {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const url = "https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}";
fetch(url, {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

<?php
$url = "https://flows.generio.ai/flows/{flow_id}/outputs/{asset_id}";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_TOKEN",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>