Skip to content

Attribution by video embedding

Request

Send the stills and motion embeddings of a video, computed in your environment by the Bria video attribution model. Only the irreversible vectors reach Bria.

Security
api_token
Bodyapplication/jsonrequired
modelstring(VideoAttributionModel)required

The Bria video model that produced the video, as model_name:version.

Enum:"video_generation:1""video_rmbg:1""video_eraser:1""video_mask:1""video_increase_res:1"
Example:"video_generation:1"
video_secondsnumberrequired

Duration of the video in seconds. Fractional values are accepted.

Example:5
stills_embedding_base64stringrequired

Base64-encoded stills embedding of the video.

Example:"<stills_embedding_base64>"
motion_embedding_base64stringrequired

Base64-encoded motion embedding of the video.

Example:"<motion_embedding_base64>"
unique_idstring(UniqueId)

Optional. Your identifier for this embedding; use a new value per asset. Bria generates one if omitted.

Example:"3f2b9c1e8a7d4f6b9e0c1a2b3c4d5e6f"
agentstring(Agent)

Optional. A name for the application, integration or end customer that produced the asset. Stored with the attribution record.

Example:"my-app"
syncboolean(Sync)

Specifies the response mode. Optional.

  • When false (default), the API returns 202 with a request_id and status_url right away.
  • When true, the API returns 200 with the outcome once the attribution request is queued.
Default:false
Example:false
webhook_urlstring, (uri)(WebhookUrl)

Optional URL for receiving the result via webhook when the async job completes. See webhooks.

Example:"https://example.com/webhooks/bria"
POST
/v2/video/attribution/by_embedding
from bria_client import BriaSyncClient

client = BriaSyncClient()  # reads BRIA_API_TOKEN

response = client.run(
    endpoint="video/attribution/by_embedding",
    payload={
        "model": "video_generation:1",
        "video_seconds": 5,
        "stills_embedding_base64": "<stills_embedding_base64>",
        "motion_embedding_base64": "<motion_embedding_base64>",
        "agent": "my-app",
    },
)
print(response.result)

Responses

Attribution triggered (returned when sync is true).

Bodyapplication/json
resultobjectrequired
request_idstringrequired
Response
{ "result": { "content": "Attribution triggered successfully" }, "request_id": "string" }