Skip to content
FLORA FLORA API

Get a run

GET
/runs/{runId}
 
import { FloraClient } from '@flora-ai/flora';


const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });


const generation = await client.generations.retrieve({
  runId: '<runId>',
});
console.log(generation);

Returns status and completed output URLs for a public API run, including action runs started through POST /runs/action.

Error responses use the standard error body.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
runId
required

Run identifier

string
/^run_\S+$/

Run identifier

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Run returned.

Media type application/json
object
run_id
required

Run identifier

string
/^run_\S+$/
status
required
string
Allowed values: pending running completed failed
progress
required
number
created_at
required
number
started_at
number
completed_at
number
error_code

Machine-readable run error code

string
error_message

Human-readable run error message

string
charged_cost

Cost charged in USD

number
outputs
Array<object>
object
output_id
required

Run output identifier

string
type
required

Run output media type

string
Allowed values: imageUrl videoUrl audioUrl text documentUrl model3dUrl
url
required

Run output URL or text content

string
>= 1 characters
asset_id

Asset identifier for durable media outputs

string
/^asset_\S+$/
label

Optional output label

string
tri_count

Triangle count for model3d outputs

integer
bbox

Axis-aligned local bounds for model3d outputs

object
min
required
array
max
required
array
textured

Whether the model3d output carries textures

boolean
poll_url

URL to poll pending/running runs or fetch completed/failed run details.

string format: uri
Example 
{
  "run_id": "run_abc123",
  "status": "pending",
  "error_code": "provider_error",
  "error_message": "The provider failed to complete the generation.",
  "outputs": [
    {
      "output_id": "output_1",
      "type": "imageUrl",
      "url": "https://media.flora.ai/output.png",
      "asset_id": "asset_abc123",
      "label": "preview"
    }
  ]
}