实时通信

实时音视频房间、按参与者的访问令牌、服务端录制与参与者管理，覆盖 LiveKit / Agora / Zego。

概览

基础路径: https://api.infrai.cc/v1/rtc

鉴权头: Authorization: Bearer $INFRAI_API_KEY

bash

# Call any /v1/rtc capability over raw HTTP — no SDK to install.
# curl:
curl https://api.infrai.cc/v1/rtc/... \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json"

方法

rtc.room.create

POST /v1/rtc/room/create

在所选 RTC vendor 上创建实时音视频房间。部分 vendor（Agora/Zego）无持久房间对象——房间在首次加入时具现，记录为合成。

参数

名称	类型	必填	说明
`name`	`string`	必填	房间名称（账户内唯一）。
`max_participants`	`number`	可选	最大并发参与者数。
`empty_timeout_s`	`number`	可选	空闲多少秒后自动关闭。
`metadata`	`Record<string, unknown>`	可选	任意键值元数据。
`enable_recording`	`boolean`	可选	为房间启用录制。
`region`	`string`	可选	承载房间的边缘区域。
`vendor`	`string`	可选	显式 vendor 锁定。
`idempotency_key`	`string`	可选	客户端提供的幂等键。

Room { room, name, max_participants, created_at }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X POST https://api.infrai.cc/v1/rtc/room/create \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "..."}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/room/create",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'name': '...'},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"name": "..."}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"name": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.room.get

GET /v1/rtc/room/get/{room}

获取单个 RTC 房间的状态与实时在线人数。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。

Room

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X GET https://api.infrai.cc/v1/rtc/room/get/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/room/get/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/get/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/get/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.room.list

GET /v1/rtc/room/list

列出账户下活跃的 RTC 房间 / 频道。

参数

名称	类型	必填	说明
`cursor`	`string`	可选	不透明分页游标。
`limit`	`number`	可选	返回条目的最大数量。

{ items: Room[], next_cursor?: string }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X GET https://api.infrai.cc/v1/rtc/room/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/room/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.room.delete

DELETE /v1/rtc/room/delete/{room}

关闭 RTC 房间（无删除 API 的 vendor 会在空闲时自动关闭）。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。

{ ok: boolean }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X DELETE https://api.infrai.cc/v1/rtc/room/delete/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.token.issue

POST /v1/rtc/token/issue

为单个参与者签发加入令牌（vendor 原生 JWT/AccessToken2/token04，本地签名）。概念上按参与者分钟计费；带宽 / 出口按成本兜底。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。
`identity`	`string`	必填	参与者唯一身份 / uid。
`display_name`	`string`	可选	参与者可读名称。
`ttl_s`	`number`	可选	令牌有效时长（秒）。
`can_publish`	`boolean`	可选	允许参与者发布媒体流。
`can_subscribe`	`boolean`	可选	允许参与者订阅媒体流。
`can_publish_data`	`boolean`	可选	允许参与者发布数据消息。
`is_admin`	`boolean`	可选	授予参与者管理员权限。
`vendor`	`string`	可选	显式 vendor 锁定。
`metadata`	`Record<string, unknown>`	可选	任意键值元数据。

AccessToken { token, room, identity, expires_at }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X POST https://api.infrai.cc/v1/rtc/token/issue \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room": "...", "identity": "..."}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/token/issue",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'room': '...', 'identity': '...'},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/token/issue",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/token/issue",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.recording.start

POST /v1/rtc/recording/start

对房间启动服务端合成录制（LiveKit Egress）；其他 vendor 返回明确的不支持错误。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。
`layout`	`string`	可选	录制合成布局。
`audio_only`	`boolean`	可选	仅录制音频。
`output_uri`	`string`	可选	存储目标（s3://、gs:// 等）。
`vendor`	`string`	可选	显式 vendor 锁定。
`metadata`	`Record<string, unknown>`	可选	任意键值元数据。
`idempotency_key`	`string`	可选	客户端提供的幂等键。

Recording { recording, room, status }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X POST https://api.infrai.cc/v1/rtc/recording/start \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room": "..."}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/recording/start",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'room': '...'},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/start",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "..."}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/start",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.recording.stop

POST /v1/rtc/recording/stop/{recording}

停止进行中的录制。

参数

名称	类型	必填	说明
`recording`	`string`	必填	录制 id。

Recording { recording, status, output_uri? }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X POST https://api.infrai.cc/v1/rtc/recording/stop/RECORDING \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.participant.list

GET /v1/rtc/participant/list/{room}

列出房间中当前的参与者。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。

{ items: Array<{ identity, display_name?, joined_at }> }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X GET https://api.infrai.cc/v1/rtc/participant/list/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

rtc.participant.kick

POST /v1/rtc/participant/kick/{room}

强制将参与者从房间移除（踢出）。

参数

名称	类型	必填	说明
`room`	`string`	必填	房间 id。
`identity`	`string`	必填	参与者唯一身份 / uid。
`vendor`	`string`	可选	显式 vendor 锁定。

{ ok: boolean }

示例

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

curl -X POST https://api.infrai.cc/v1/rtc/participant/kick/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room": "...", "identity": "..."}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/participant/kick/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'room': '...', 'identity': '...'},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/kick/ROOM",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/kick/ROOM",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

高级:指定 vendor

默认情况下 infrai 会把每次调用智能路由到最佳可用供应商——无需自己挑选 vendor。作为高级逃生口,本能力支持可选的 vendor 入参以锁定某个供应商。本能力当前所有可用 vendor 可通过该能力 id 对应的 discovery 端点实时获取——参见 discovery API。

GET /v1/discovery/{capability}

rtc.room.create

rtc.token.issue

rtc.recording.start

rtc.participant.kick

全部能力

本模块全部已路由能力——完整的对外 REST 契约。上方方法是带讲解的入门示例,此表是完整参考。

能力	端点	说明
`rtc.participant.kick`	`POST /v1/rtc/participant/kick/{room}`	Forcibly remove (kick) a participant from a room.
`rtc.participant.list`	`GET /v1/rtc/participant/list/{room}`	List participants currently in a room.
`rtc.recording.start`	`POST /v1/rtc/recording/start`	Start a server-side composite recording of a room (LiveKit Egress); other vendors return an honest unsupported error.
`rtc.recording.stop`	`POST /v1/rtc/recording/stop/{recording}`	Stop an in-progress recording.
`rtc.room.create`	`POST /v1/rtc/room/create`	Create a live audio/video room on the selected RTC vendor. Some vendors (Agora/Zego) have no persistent room object — the room materializes on first join and the record is synthesized.
`rtc.room.delete`	`DELETE /v1/rtc/room/delete/{room}`	Close an RTC room (vendors without a delete API auto-close when empty).
`rtc.room.get`	`GET /v1/rtc/room/get/{room}`	Fetch a single RTC room's state and live occupancy.
`rtc.room.list`	`GET /v1/rtc/room/list`	List active RTC rooms / channels for the account.
`rtc.token.issue`	`POST /v1/rtc/token/issue`	Mint a per-participant join token (vendor-native JWT/AccessToken2/token04, signed locally). Billed per participant-minute conceptually; bandwidth/egress floored at cost.

完整示例

本模块的生产级端到端范例:先一次性配置,再运行业务流程,尽量覆盖本模块的多数 API。

单文件可运行 Python 程序(仅标准库、无 SDK):拷贝后填入 INFRAI_API_KEY 运行,即可按真实业务流逐步体验本模块核心 API——每一步都真实调用并计费,后续步骤复用前一步返回的真实字段。12 行 helper 就是全部集成代码。

python

#!/usr/bin/env python3
"""Infrai · rtc — runnable real-app example (single file, zero deps).

Copy this file, set your key, run it: every step is a REAL call to
api.infrai.cc, billed at the real (tiny) per-call price, printing the
live JSON response. Get a key at https://console.infrai.cc (Google/
GitHub sign-in grants $2 free credit). No SDK — the 12-line helper
below is the entire integration."""
import json
import os
from urllib import error, request

KEY = os.environ.get("INFRAI_API_KEY") or "ifr_pk_proj_..."  # <- your key
BASE = "https://api.infrai.cc"


# Same raw HTTPS POST/GET as every per-method example on this page —
# wrapped once for reuse. There is nothing else to it: no SDK.
def infrai(method, path, body=None):
    req = request.Request(
        BASE + path, method=method,
        data=json.dumps(body).encode() if body is not None else None,
        headers={"Authorization": f"Bearer {KEY}",
                 "Content-Type": "application/json"})
    try:
        with request.urlopen(req, timeout=60) as r:
            return json.loads(r.read())
    except error.HTTPError as e:
        return json.loads(e.read())


def show(label, resp):
    print(f"\n== {label} ==")
    print(json.dumps(resp, indent=2, ensure_ascii=False))
    return resp


# 1) rtc.room.create — POST /v1/rtc/room/create · Create a live audio/video room on the selected RTC vendor. Some vendors (Agora/Zego) have no persistent room object — the room materializes on first join and the record is synthesized.
r1 = show("rtc.room.create", infrai("POST", "/v1/rtc/room/create", {"name":"..."}))

# 2) rtc.token.issue — POST /v1/rtc/token/issue · Mint a per-participant join token (vendor-native JWT/AccessToken2/token04, signed locally). Billed per participant-minute conceptually; bandwidth/egress floored at cost.
r2 = show("rtc.token.issue", infrai("POST", "/v1/rtc/token/issue", {"room":"...","identity":"..."}))

# 3) rtc.recording.start — POST /v1/rtc/recording/start · Start a server-side composite recording of a room (LiveKit Egress); other vendors return an honest unsupported error.
r3 = show("rtc.recording.start", infrai("POST", "/v1/rtc/recording/start", {"room":"..."}))

# 4) rtc.room.list — GET /v1/rtc/room/list · List active RTC rooms / channels for the account.
r4 = show("rtc.room.list", infrai("GET", "/v1/rtc/room/list"))

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at the console: Google/GitHub gives you
# $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
# POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."

bash

# 1) Auth: every call is a raw HTTPS request to the Infrai gateway carrying
#    only your project key. No SDK, no install.
#    Get your key: sign in with Google/GitHub at the console for a project key
#    + $2 free credit (email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT,
#    POST /v1/account/topup and open the returned checkout_url.
export INFRAI_API_KEY="ifr_pk_proj_..."   # from the console


# 2) rtc.room.create
curl -X POST https://api.infrai.cc/v1/rtc/room/create \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "..."}'

# 3) rtc.room.get
curl -X GET https://api.infrai.cc/v1/rtc/room/get/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 4) rtc.room.list
curl -X GET https://api.infrai.cc/v1/rtc/room/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 5) rtc.room.delete
curl -X DELETE https://api.infrai.cc/v1/rtc/room/delete/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 6) rtc.token.issue
curl -X POST https://api.infrai.cc/v1/rtc/token/issue \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room": "...", "identity": "..."}'

# 7) rtc.recording.start
curl -X POST https://api.infrai.cc/v1/rtc/recording/start \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room": "..."}'

# 8) rtc.recording.stop
curl -X POST https://api.infrai.cc/v1/rtc/recording/stop/RECORDING \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# 9) rtc.participant.list
curl -X GET https://api.infrai.cc/v1/rtc/participant/list/ROOM \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

# 1) Auth: every call is a raw HTTPS request carrying only your project key.
#    No SDK to install — just the `requests` library.
import os, requests

BASE = "https://api.infrai.cc"
HEADERS = {
    "Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}",
    "Content-Type": "application/json",
}


# 2) rtc.room.create
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/room/create",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'name': '...'},
)
resp.raise_for_status()
print(resp.json())

# 3) rtc.room.get
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/room/get/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 4) rtc.room.list
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/room/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 5) rtc.room.delete
import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 6) rtc.token.issue
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/token/issue",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'room': '...', 'identity': '...'},
)
resp.raise_for_status()
print(resp.json())

# 7) rtc.recording.start
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/recording/start",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'room': '...'},
)
resp.raise_for_status()
print(resp.json())

# 8) rtc.recording.stop
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={},
)
resp.raise_for_status()
print(resp.json())

# 9) rtc.participant.list
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch().
const BASE = "https://api.infrai.cc";
const HEADERS = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) rtc.room.create
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"name": "..."}),
  },
);
console.log(await resp.json());

// 3) rtc.room.get
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/get/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 4) rtc.room.list
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 5) rtc.room.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 6) rtc.token.issue
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/token/issue",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
console.log(await resp.json());

// 7) rtc.recording.start
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/start",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "..."}),
  },
);
console.log(await resp.json());

// 8) rtc.recording.stop
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({}),
  },
);
console.log(await resp.json());

// 9) rtc.participant.list
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch(), typed.
const BASE = "https://api.infrai.cc";
const HEADERS: Record<string, string> = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) rtc.room.create
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/create",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"name": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 3) rtc.room.get
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/get/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 4) rtc.room.list
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 5) rtc.room.delete
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/room/delete/ROOM",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 6) rtc.token.issue
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/token/issue",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "...", "identity": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 7) rtc.recording.start
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/start",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"room": "..."}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 8) rtc.recording.stop
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/recording/stop/RECORDING",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 9) rtc.participant.list
const resp = await fetch(
  "https://api.infrai.cc/v1/rtc/participant/list/ROOM",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);