tldv

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Troubleshooting

故障排查

If requests fail, run

zero doctor check-connector --env-name TLDV_TOKEN

zero doctor check-connector --url https://pasta.tldv.io/v1alpha1/health --method GET

如果请求失败，请运行

zero doctor check-connector --env-name TLDV_TOKEN

或

zero doctor check-connector --url https://pasta.tldv.io/v1alpha1/health --method GET

How to Use

使用方法

All examples below assume you have

TLDV_TOKEN

set.

Base URL:

https://pasta.tldv.io

API version:

v1alpha1

(alpha — endpoints may change before stable v1 release).

Authentication uses the

x-api-key

header (not Bearer).

以下所有示例均假设您已设置

TLDV_TOKEN

。

基础URL：

https://pasta.tldv.io

API版本：

v1alpha1

（测试版——正式v1版本发布前，端点可能会变更）。

认证使用

x-api-key

请求头（而非Bearer认证）。

Health Check

健康检查

Verify API Connectivity

验证API连通性

bash

curl -s "https://pasta.tldv.io/v1alpha1/health" --header "x-api-key: $TLDV_TOKEN" | jq .

bash

curl -s "https://pasta.tldv.io/v1alpha1/health" --header "x-api-key: $TLDV_TOKEN" | jq .

Meetings

会议相关

List Meetings

列出会议

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings" --header "x-api-key: $TLDV_TOKEN" | jq '.results[] | {id, name, happenedAt, duration, organizer: .organizer.name}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings" --header "x-api-key: $TLDV_TOKEN" | jq '.results[] | {id, name, happenedAt, duration, organizer: .organizer.name}'

List Meetings with Pagination

分页列出会议

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings?page=1&pageSize=10" --header "x-api-key: $TLDV_TOKEN" | jq '{page, pages, total, meetings: [.results[] | {id, name, happenedAt}]}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings?page=1&pageSize=10" --header "x-api-key: $TLDV_TOKEN" | jq '{page, pages, total, meetings: [.results[] | {id, name, happenedAt}]}'

Get Meeting by ID

通过ID获取会议详情

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>" --header "x-api-key: $TLDV_TOKEN" | jq '{id, name, happenedAt, duration, url, organizer, invitees}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>" --header "x-api-key: $TLDV_TOKEN" | jq '{id, name, happenedAt, duration, url, organizer, invitees}'

Download Meeting Recording

下载会议录制文件

Returns a 302 redirect to a signed download URL (expires after 6 hours). Use

-L

to follow the redirect, or omit it to inspect the URL:

bash

curl -s -I "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/download" --header "x-api-key: $TLDV_TOKEN" | grep -i location

To download the recording directly:

bash

curl -s -L -o /tmp/tldv_recording.mp4 "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/download" --header "x-api-key: $TLDV_TOKEN"

返回302重定向至签名下载URL（6小时后过期）。使用

-L

参数跟随重定向，或省略该参数查看URL：

bash

curl -s -I "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/download" --header "x-api-key: $TLDV_TOKEN" | grep -i location

直接下载录制文件：

bash

curl -s -L -o /tmp/tldv_recording.mp4 "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/download" --header "x-api-key: $TLDV_TOKEN"

Import a Meeting

导入会议

Write to

/tmp/tldv_request.json

json

{
  "url": "https://example.com/recording.mp4"
}

bash

curl -s -X POST "https://pasta.tldv.io/v1alpha1/meetings/import" --header "x-api-key: $TLDV_TOKEN" --header "Content-Type: application/json" -d @/tmp/tldv_request.json | jq .

将以下内容写入

/tmp/tldv_request.json

：

json

{
  "url": "https://example.com/recording.mp4"
}

bash

curl -s -X POST "https://pasta.tldv.io/v1alpha1/meetings/import" --header "x-api-key: $TLDV_TOKEN" --header "Content-Type: application/json" -d @/tmp/tldv_request.json | jq .

Transcripts

转录文本

Get Meeting Transcript

获取会议转录文本

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/transcript" --header "x-api-key: $TLDV_TOKEN" | jq '.data[] | {speaker, text, startTime, endTime}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/transcript" --header "x-api-key: $TLDV_TOKEN" | jq '.data[] | {speaker, text, startTime, endTime}'

Get Full Transcript as Plain Text

获取纯文本格式的完整转录文本

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/transcript" --header "x-api-key: $TLDV_TOKEN" | jq -r '.data[] | "\(.speaker): \(.text)"'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/transcript" --header "x-api-key: $TLDV_TOKEN" | jq -r '.data[] | "\(.speaker): \(.text)"'

Highlights / Notes

重点内容/笔记

Get Meeting Highlights

获取会议重点内容

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/highlights" --header "x-api-key: $TLDV_TOKEN" | jq '.data[] | {text, startTime, source, topic: .topic.title, summary: .topic.summary}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/highlights" --header "x-api-key: $TLDV_TOKEN" | jq '.data[] | {text, startTime, source, topic: .topic.title, summary: .topic.summary}'

Get Topic Summaries Only

仅获取主题摘要

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/highlights" --header "x-api-key: $TLDV_TOKEN" | jq '[.data[] | .topic | select(. != null)] | unique_by(.title) | .[] | {title, summary}'

bash

curl -s "https://pasta.tldv.io/v1alpha1/meetings/<meeting_id>/highlights" --header "x-api-key: $TLDV_TOKEN" | jq '[.data[] | .topic | select(. != null)] | unique_by(.title) | .[] | {title, summary}'

Guidelines

使用指南

Authentication uses the

x-api-key

header, not

Authorization: Bearer

. Every request must include

--header "x-api-key: $TLDV_TOKEN"

The API is versioned at
```
v1alpha1
```
. This is an alpha API — endpoints and response formats may change.
All requests must use HTTPS. Plain HTTP requests are rejected.
API access requires the meeting organizer to have a Pro, Business, or Enterprise plan. Free plan organizers have no API access.
Meeting IDs are strings. Use
```
jq
```
to extract
```
id
```
fields from list responses.
Transcripts are only returned when processing is complete. If a meeting was just recorded, the transcript may not be available yet.
Download URLs from the
```
/download
```
endpoint expire after 6 hours.
Pagination: the meetings list returns
```
page
```
,
```
pages
```
,
```
total
```
, and
```
pageSize
```
fields. Use
```
?page=N
```
to navigate pages.
Use
```
<placeholder>
```
for dynamic IDs that the user must replace (e.g.,
```
<meeting_id>
```
).
Write request bodies to
```
/tmp/tldv_request.json
```
before sending.

认证使用

x-api-key

请求头，而非

Authorization: Bearer

。每个请求都必须包含

--header "x-api-key: $TLDV_TOKEN"

。

API版本为
```
v1alpha1
```
，属于测试版API——端点和响应格式可能会变更。
所有请求必须使用HTTPS，纯HTTP请求会被拒绝。
API访问要求会议组织者拥有Pro、Business或Enterprise计划，免费版组织者无法访问API。
会议ID为字符串，可使用
```
jq
```
从列表响应中提取
```
id
```
字段。
仅当处理完成后才会返回转录文本，如果会议刚录制完成，转录文本可能尚未就绪。
```
/download
```
端点返回的下载URL会在6小时后过期。
分页：会议列表会返回
```
page
```
、
```
pages
```
、
```
total
```
和
```
pageSize
```
字段，使用
```
?page=N
```
参数切换页面。
使用
```
<placeholder>
```
表示用户必须替换的动态ID（例如
```
<meeting_id>
```
）。
发送请求前，需将请求体写入
```
/tmp/tldv_request.json
```
。