roasOSGet the finished ad analysis
The analysis document. An analysis that is not finished answers 409 analysis_not_completed.
The analysis document. An analysis that is not finished answers 409 analysis_not_completed.
Authorization
bearerAuth API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...
In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workflows/analyses/497f6eca-6276-4993-bfeb-53cbbbba6f08/result"{ "data": { "schema_version": "workflow-analysis-result@1", "kind": "workflow_analysis_result", "analysis_id": "6ad457ea-9426-4897-bff8-c6f3fe690582", "workflow": "analyze", "status": "succeeded", "analysis_kind": "image", "cache_disposition": "cache_hit", "model": "string", "pricing_version": "string", "reserved_credits": 0, "maximum_credits": 0, "settled_credits": 0, "completed_at": "2019-08-24T14:15:22Z", "analysis": { "property1": null, "property2": null }, "measured_cuts": { "property1": null, "property2": null } }}Get ad analysis status
The light poll: the same envelope, read while the analysis runs.
Recast a video
Recast one video with your own person and product. Send exactly one source (`source_video_url` or `source_generation_id`), a `prompt`, and at least one target: `avatar_id`, `product_id`, `references` (on the seedance-2.5-edit lane) or `elements` (Kling only). Without a target this is a plain video edit and the call is refused with `recast_target_required`. The source must be workspace-owned media or a Discover creative (`discover/items/v2/...`): a Discover ad can be recast on purpose. Any other URL is refused with `reference_media_not_workspace_owned`. The default model is seedance-2.5-edit (the preserve-video role). A body that sends `elements` and no `model` runs on kling-4, because only Kling takes elements. Other choices: kling-4, seedance-2.5-edit. Quoting, idempotency, the job envelope, webhooks and refunds are the same as the chosen model's own endpoint.