Get the result
Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.
/api/v1/generations/{id}Bearer API keyRequest
curl 'https://01router.com/api/v1/generations/gen_example' \
-H "Authorization: Bearer $API_KEY"Input parameters
Query / path parametersidstring · pathRequiredGeneration ID returned by the create request.
Response example
{
"id": "gen_example",
"object": "generation",
"model": "seedance-2.5",
"type": "video",
"provider": "01router",
"status": "succeeded",
"input": {
"prompt": "A red fox running through fresh snow, cinematic"
},
"outputs": [
"https://example.com/result.mp4"
],
"error": null,
"credits": 100,
"price_usd": 1,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": "2026-10-25T08:01:00.000Z"
}Responses are illustrative. IDs, usage, prices and results depend on the actual request.
Response fields
idstringGeneration ID returned by the create request.
object"generation"generation
modelstringModel slug from the catalog. Project keys may use a project-specific model slug.
typevideo | image | audio | chatproviderstringOptional provider slug. Omit for automatic routing; project settings may pin the provider.
statusstringqueued / processing / succeeded / failed. Stop polling on succeeded or failed.
inputobjectModel-specific input object. See the selected model reference for required fields, defaults and limits.
outputsstring[]Result file URLs. Empty until available; download promptly because URLs may expire.
errorstring | nullError message on failure; null otherwise.
creditsnumberCredits charged for this generation; zero after a refund.
price_usdnumberPrice of this generation in USD; zero after a refund.
created_atstringCreation time in ISO 8601 format.
completed_atstring | nullCompletion time in ISO 8601 format, or null while running.
Usage notes
- Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.
Use with AI
Give your coding assistant the documentation index or the full API reference, including live model parameters.