Text to Keyframe (with Metadata Filters) | Coactive AI

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

dataset_idstringRequiredformat: "uuid"

Dataset to search within

text_querystringRequired>=2 characters

Natural language query encoded into an embedding to score visual content via vector similarity.

limitintegerOptional1-100Defaults to 40

Max number of results to return

offsetintegerOptional>=0Defaults to 0

Number of results to skip before returning

metadata_filterslist of objectsOptional

List of filter objects applied against asset metadata fields before scoring. All filters are combined with AND.

skip_moderationbooleanOptionalDefaults to false

When true, moderation scoring is skipped and moderation_score will be null on all results.

Successful Response

run_idinteger

Databricks job run ID to use for status polling and result retrieval

422

Unprocessable Entity Error

$	curl -X POST https://api.coactive.ai/api/v0/search/metadata-filters/text-to-keyframe \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"dataset_id": "a3f1c9d2-7b4e-4f8a-9d3e-2c1b5f6a7e8d",
>	"text_query": "upbeat music video with dancing"
>	}'