Assets API

Browse and retrieve completed job outputs including images, videos, and audio files.

Endpoints

GET

/api/v1/assets

List your assets

GET

/api/v1/assets/{id}

Get a specific asset

List Assets

GET

/api/v1/assets

Query Parameters

Name	Type	Description
`workflow`	`string`	Filter by workflow slug (e.g., 'generate_video', 'generate_image')
`limit`	`number`Default: `20`	Max results (1-100)
`offset`	`number`Default: `0`	Pagination offset

Example Requestbash

curl "https://vydra.ai/api/v1/assets?workflow=generate_video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)json

{
  "data": [
    {
      "id": "ast_a1b2c3d4e5f6",
      "type": "video",
      "workflow": "generate_video",
      "url": "https://pub-xxx.r2.dev/videos/output.mp4",
      "thumbnailUrl": "https://pub-xxx.r2.dev/videos/thumbnail.jpg",
      "metadata": {
        "prompt": "A golden retriever running on a beach at sunset",
        "model": "veo3",
        "duration": 8
      },
      "jobId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-26T12:15:00.000Z"
    },
    {
      "id": "ast_f6e5d4c3b2a1",
      "type": "image",
      "workflow": "generate_image",
      "url": "https://pub-xxx.r2.dev/images/output.png",
      "metadata": {
        "prompt": "Cyberpunk cityscape at night",
        "model": "gemini-image"
      },
      "jobId": "660e8400-e29b-41d4-a716-446655440001",
      "createdAt": "2026-01-26T11:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "count": 2
  }
}

Get Asset

GET

/api/v1/assets/{id}

Example Requestbash

curl https://vydra.ai/api/v1/assets/ast_a1b2c3d4e5f6 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)json

{
  "id": "ast_a1b2c3d4e5f6",
  "type": "video",
  "workflow": "generate_video",
  "url": "https://pub-xxx.r2.dev/videos/output.mp4",
  "thumbnailUrl": "https://pub-xxx.r2.dev/videos/thumbnail.jpg",
  "metadata": {
    "prompt": "A golden retriever running on a beach at sunset",
    "model": "veo3",
    "duration": 8,
    "aspect_ratio": "16:9"
  },
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-26T12:15:00.000Z"
}

Asset Retention

Assets are stored permanently. URLs are stable and can be used directly in your application.