Yapper Developers
Api reference
GET
/assets

Lists normalized team assets, newest first. type is required. V1 supports at most one of processType, source, model, tool, genType, or folderId per request (unsupported combinations return unsupported_filter_combination); favorite composes with any of them.

Authorization

bearerAuth assets:read
AuthorizationBearer <token>

In: header

Scope: assets:read

Query Parameters

type*string

Value in

  • "image"
  • "video"
  • "audio"
favorite?boolean

Only favorited assets. Composes with any other filter.

folderId?string

Mutually exclusive with the tag filters in V1.

source?string

Value in

  • "upload"
  • "provided"
  • "image-gen-process"
  • "video-generation-process"
  • "timeline-export"
type?string
model?string
tool?string
genType?string

Value in

  • "video-sync"
  • "image-to-video"
  • "image-to-video-sync"
  • "text-to-video"
limit?integer
Range1 <= value <= 100
Default20
cursor?string

Opaque pagination cursor — pass the nextCursor from the previous page verbatim. nextCursor is null on the last page.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/assets"
{  "data": [    {      "id": "string",      "type": "image",      "name": "string",      "url": "http://example.com",      "thumbnailUrl": "http://example.com",      "width": 0,      "height": 0,      "duration": 0,      "mimeType": "string",      "source": "string",      "sourceProcessId": "string",      "favorite": true,      "createdAt": "2019-08-24T14:15:22Z",      "links": {        "self": "string"      }    }  ],  "nextCursor": "string"}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}

Import an asset POST

Imports an external image or video URL into the team asset library (e.g. before starting a process). Spends no credits. Download failures return 400 with code import_failed.

List models GET

Returns public-safe model metadata and capabilities. startable: true means the model's type can be started via POST /processes in V1; other types (lip-sync, avatars, music, etc.) appear in process and asset reads but cannot be started yet.