resources

Import a stock candidate or a curated SFX-pack sound

Two lanes. STOCK { projectId, candidateId }: import a candidate returned by search_resources into a project as an org-owned media item (preserving provider/externalId/license provenance; bytes deduped across orgs). Async: returns { id, status:'importing' }; status flips to complete when the import finishes (poll GET /media/:id). A candidate whose 7-day search cache has expired returns 422 — re-search. PACK { kind:"sfx-pack", id:<soundId> }: mint/return the org media item for a curated CC0 SFX-pack sound (soundId from list_catalog's sfx[]) — returns { id, status:'ready' } immediately to place as a normal sfx clip. Idempotent per (org, soundId); an unknown soundId is a 422. Pack imports are FREE: no plan feature required, and an x402 payment is released unsettled (no charge). PRICE of a stock import for a keyed (API-key / session) caller: 0 credits — the resource_import entitlement is a plan grant, not a meter (get_account reports entitlements.resource_import.listUsdPerUnit: 0); the imported bytes count toward the storage gauge. Only an unkeyed x402 caller pays the $0.01 import tier.

post/v1/resources/import

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/resources/import
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:write)
    • API key in header PAYMENT-SIGNATURE

Request body

kind'sfx-pack' | 'music-pack'
idstring
projectIdstring
candidateIdstring

Example request

{
  "projectId": "abcdefghij1234567890abcdef123456",
  "candidateId": "cand_01J8Z3K9Q2X4Y5W6V7T8R9S0P1"
}

Response

Import reserved.

idstring required
status'importing' | 'ready' required

Changes

No recorded changes to this operation across all 1 revision of this API.