Fill missing key, tempo, and time signature for a batch of songs

POST

/api/ai/infer-metadata-batch

• Production
• Local Development

Null-only writes — fields the band already set are never overwritten. One AI quota debit covers the whole batch (ADR-0082); clients loop batches for larger libraries.

Authorizations

• bearerAuth

Request Body^required

object

songIds

required

Array<string>

>= 1 items <= 25 items

Responses

200

Count of songs that received at least one field

object

ok

required

boolean

data

required

object

filledCount

required

integer

400

Invalid request or missing band context

object

ok

required

boolean

error

required

string

code

string

401

Unauthenticated

object

ok

required

boolean

error

required

string

code

string

403

No song edit access or no AI access

object

ok

required

boolean

error

required

string

code

string

500

AI not configured or inference failed

object

ok

required

boolean

error

required

string

code

string