magic_hour 0.71.0

Magic Hour Rust SDK
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# v1.video_projects

## Module Functions

### Delete video <a name="delete"></a>

Permanently delete the rendered video. This action is not reversible, please be sure before deleting.

**API Endpoint**: `DELETE /v1/video-projects/{id}`

#### Parameters

| Parameter | Required | Description                                                                                         | Example                      |
| --------- | :------: | --------------------------------------------------------------------------------------------------- | ---------------------------- |
| `id`      |    ✓     | Unique ID of the video project. This value is returned by all of the POST APIs that create a video. | `"cuid-example".to_string()` |

#### Example Snippet

```rust
let client = magic_hour::Client::default()
    .with_bearer_auth(&std::env::var("API_TOKEN").unwrap());
let res = client
    .v1()
    .video_projects()
    .delete(magic_hour::resources::v1::video_projects::DeleteRequest {
        id: "cuid-example".to_string(),
    })
    .await;
```

### Get video details <a name="get"></a>

Check the progress of a video project. The `downloads` field is populated after a successful render.

**Statuses**

- `queued` — waiting to start
- `rendering` — in progress
- `complete` — ready; see `downloads`
- `error` — a failure occurred (see `error`)
- `canceled` — user canceled
- `draft` — not used

**API Endpoint**: `GET /v1/video-projects/{id}`

#### Parameters

| Parameter | Required | Description                                                                                         | Example                      |
| --------- | :------: | --------------------------------------------------------------------------------------------------- | ---------------------------- |
| `id`      |    ✓     | Unique ID of the video project. This value is returned by all of the POST APIs that create a video. | `"cuid-example".to_string()` |

#### Example Snippet

```rust
let client = magic_hour::Client::default()
    .with_bearer_auth(&std::env::var("API_TOKEN").unwrap());
let res = client
    .v1()
    .video_projects()
    .get(magic_hour::resources::v1::video_projects::GetRequest {
        id: "cuid-example".to_string(),
    })
    .await;
```

#### Response

##### Type

[V1VideoProjectsGetResponse](/src/models/v1_video_projects_get_response.rs)

##### Example

```rust
V1VideoProjectsGetResponse {created_at: "1970-01-01T00:00:00".to_string(), credits_charged: 450, download: Some(V1VideoProjectsGetResponseDownload {expires_at: "2024-10-19T05:16:19.027Z".to_string(), url: "https://videos.magichour.ai/id/output.mp4".to_string()}), downloads: vec![V1VideoProjectsGetResponseDownloadsItem {expires_at: "2024-10-19T05:16:19.027Z".to_string(), url: "https://videos.magichour.ai/id/output.mp4".to_string()}], enabled: true, end_seconds: 15.0, error: Some(V1VideoProjectsGetResponseError {code: "no_source_face".to_string(), message: "Please use an image with a detectable face".to_string()}), fps: 30.0, height: 960, id: "cuid-example".to_string(), name: Some("Example Name".to_string()), start_seconds: 0.0, status: V1VideoProjectsGetResponseStatusEnum::Complete, total_frame_cost: 123, type_: "FACE_SWAP".to_string(), width: 512}
```