# CloudToken AI Model Guide

Base URL: https://vidnovaai.com

This document is generated from the live admin configuration. When templates or cases change, this page changes with them.

## Authentication

Use the token from your account page:

```http
Authorization: Bearer <user-token>
```

## Quick Start

1. Read `/api/models` or this Markdown file to choose a template.
2. For image-to-video templates, send `templateId` and `dataUrl` to `/api/platform/generate`.
3. For text-to-video templates, send `templateId` and an optional `prompt` to `/api/platform/generate`.
4. For approved advanced Seedance generation, call `/api/advanced/generate` with `provider: "seedance"`.
5. For approved advanced Wan2.7 generation, call `/api/advanced/generate` with `provider: "wan27"`, a reference image, `resolution`, optional `seed`, and duration.
6. Query `/api/generation-records` or `/api/generation-records/<taskId>` for progress and results.

## Billing

1 CNY equals 100 credits. Advanced generation is charged by public per-second rates: Seedance 720p 150 credits/s, Seedance 1080p 300 credits/s, Wan2.7 720p 100 credits/s, Wan2.7 1080p 250 credits/s.

## Endpoints

```json
{
  "docsMarkdown": "https://vidnovaai.com/docs/models.md",
  "modelsJson": "https://vidnovaai.com/api/models",
  "platformGenerate": "https://vidnovaai.com/api/platform/generate",
  "advancedGenerate": "https://vidnovaai.com/api/advanced/generate",
  "generationRecords": "https://vidnovaai.com/api/generation-records",
  "generationRecordDetail": "https://vidnovaai.com/api/generation-records/<taskId>",
  "advancedAccessRequest": "https://vidnovaai.com/api/advanced/request-access"
}
```

## Template Gallery Models

### Silk Lounge

- templateId: `apiz-ark-seedance-2-0-3232063`
- type: `image-to-video`
- duration: 15s
- estimated cost: pricing unavailable
- preview: https://cdn-video.51sux.com/seedance-assets/raising-game/admin/platform-templates/apiz-3316584/1779367061281.mp4
- cover: /assets/admin/platform-templates/apiz-3316584-cover-1779367061281.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "apiz-ark-seedance-2-0-3232063",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Beach Veil

- templateId: `apiz-ark-seedance-2-0-3246682`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: https://cdn-video.51sux.com/seedance-assets/raising-game/admin/platform-templates/apiz-3278628/1779373503624.mp4
- cover: https://cdn-video.51sux.com/seedance-assets/raising-game/admin/platform-templates/apiz-3278628/1779373503624-cover.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "apiz-ark-seedance-2-0-3246682",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Poolside Glow

- templateId: `apiz-ark-seedance-2-0-3246687`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: /assets/admin/platform-templates/apiz-3247282-video-1779367435138.mp4
- cover: /assets/admin/platform-templates/apiz-3247282-cover-1779367435138.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "apiz-ark-seedance-2-0-3246687",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Red Resort Swim

- templateId: `gallery-red-resort-swim-3246502`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: /assets/admin/platform-templates/gallery-red-resort-swim-3246502-video-1779379517818.mp4
- cover: /assets/admin/platform-templates/gallery-red-resort-swim-3246502-cover-small.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "gallery-red-resort-swim-3246502",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Night Suite

- templateId: `gallery-night-suite-black-dress`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: /assets/admin/platform-templates/gallery-night-suite-black-dress-video-1779379570091.mp4
- cover: /assets/admin/platform-templates/gallery-night-suite-black-dress-cover-1779379570091.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "gallery-night-suite-black-dress",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Wine Lounge

- templateId: `gallery-wine-lounge-black-dress`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: /assets/admin/platform-templates/gallery-wine-lounge-black-dress-video-1779379696374.mp4
- cover: /assets/admin/platform-templates/gallery-wine-lounge-black-dress-cover-1779379696374.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "gallery-wine-lounge-black-dress",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### City Silk Robe

- templateId: `gallery-city-silk-robe`
- type: `image-to-video`
- duration: 15s
- estimated cost: 1620 credits
- preview: /assets/admin/platform-templates/gallery-city-silk-robe-video-1779379705491.mp4
- cover: /assets/admin/platform-templates/gallery-city-silk-robe-cover-1779379705491.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "gallery-city-silk-robe",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

### Black Ceremony Dance

- templateId: `gallery-black-ceremony-dance-3245694`
- type: `image-to-video`
- duration: 5s
- estimated cost: pricing unavailable
- preview: /assets/admin/platform-templates/gallery-black-ceremony-dance-3245694-video-1779379716188.mp4
- cover: /assets/admin/platform-templates/gallery-black-ceremony-dance-3245694-cover-small.jpg

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/platform/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "templateId": "gallery-black-ceremony-dance-3245694",
    "dataUrl": "data:image/png;base64,...",
    "prompt": "optional override"
  }
}
```

## Advanced Generate

Advanced generation requires approval. Request access with `POST /api/advanced/request-access`, then call `/api/advanced/generate`.

### Aria Scene - Suite Night
- caseId: `scene-suite-seductive-demo-room`
- provider: `seedance`
- access: approval required
- estimated cost: 375 credits
- description: Scene video case for Aria in Suite Night.
- preview: /assets/generated/videos/cgt-20260506123045-zwjps.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "scene-suite-seductive-demo-room",
    "provider": "seedance",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 15,
    "generateAudio": true,
    "referenceImages": [
      {
        "dataUrl": "data:image/png;base64,...",
        "fileName": "reference-1.png"
      },
      {
        "dataUrl": "data:image/png;base64,...",
        "fileName": "reference-2.png"
      }
    ]
  }
}
```

### Rose Scene - Suite Night
- caseId: `scene-pink-1777738973553-a9cfba-room`
- provider: `seedance`
- access: approval required
- estimated cost: 375 credits
- description: Scene video case for Rose in Suite Night.
- preview: /assets/generated/videos/cgt-20260506122324-g6922.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "scene-pink-1777738973553-a9cfba-room",
    "provider": "seedance",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 15,
    "generateAudio": true,
    "referenceImages": [
      {
        "dataUrl": "data:image/png;base64,...",
        "fileName": "reference-1.png"
      },
      {
        "dataUrl": "data:image/png;base64,...",
        "fileName": "reference-2.png"
      }
    ]
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260519203657-78306a`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-19 20:36
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260519203657-78306a-video-1779197919769.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260519203657-78306a",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520195502-37f00e`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-20 19:55
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520195502-37f00e-video-1779366034477.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520195502-37f00e",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520125932-937f26`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-20 12:59
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520125932-937f26-video-1779366072116.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520125932-937f26",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520125256-623de4`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-20 12:52
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520125256-623de4-video-1779366604730.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520125256-623de4",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520124026-462c9f`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-20 12:40
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520124026-462c9f-video-1779366619880.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520124026-462c9f",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520113859-2aa2a7`
- provider: `wan27`
- access: approval required
- estimated cost: 150 credits
- description: xinyi · 2026-05-20 11:38
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520113859-2aa2a7-video-1779366818444.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520113859-2aa2a7",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 10,
    "generateAudio": true
  }
}
```

### Advanced generation
- caseId: `advanced-record-cgt-20260520105719-df0c60`
- provider: `wan27`
- access: approval required
- estimated cost: 75 credits
- description: xiong · 2026-05-20 10:57
- preview: /assets/admin/advanced-cases/advanced-record-cgt-20260520105719-df0c60-video-1779366830236.mp4

Reference image: Wan2.7 uses `dataUrl` as the first frame and optional last-frame fields. Seedance uses `referenceImages` for one or more images in the same field, or `userAssetId` / `extraReferenceAssetIds` for existing uploaded assets.

**Client request**

```json
{
  "method": "POST",
  "url": "https://vidnovaai.com/api/advanced/generate",
  "headers": {
    "Authorization": "Bearer <user-token>",
    "Content-Type": "application/json"
  },
  "body": {
    "caseId": "advanced-record-cgt-20260520105719-df0c60",
    "provider": "wan27",
    "prompt": "your prompt",
    "dataUrl": "data:image/png;base64,...",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "generateAudio": true
  }
}
```