Realtime Clip Service dashboard and API

Status dashboard and bidirectional gRPC API test for the live avatar runtime.

Service

gRPC...

Readiness...

Streams...

Avatar...

Model...

Background...

Placement...

Output...

Render

WAV file Access token

Contract

API name: rcgs.v1.RealtimeClipGeneration/GenerateClip Bidirectional gRPC stream.

from live_avatar import rcgs_pb2, rcgs_pb2_grpc

async with grpc.aio.insecure_channel("localhost:50051") as channel:
    client = rcgs_pb2_grpc.RealtimeClipGenerationStub(channel)
    responses = client.GenerateClip(request_stream())

Accepts 3 stream message payloads:

init

SessionInit

Required first message; must be sent exactly once.

chunk

AudioChunk

Zero or more audio chunks after init; one chunk must set is_final=true.

cancel

Cancel

Optional cancellation after init; returns one CANCELLED response.

SessionInit accepts 7 fields:

session_id

str

Required non-empty ID; reused by every chunk/cancel.

sample_rate

Literal[24000]

Audio must be 24 kHz.

channels

Literal[1]

Mono audio only.

avatar_id

Literal["active avatar/model"] | ""

Optional; if provided, must match the active live-avatar character.

target_fps

Literal[active fps] | 0

Optional; non-zero value must match the active generator FPS.

width

Literal[active width] | 0

Optional; non-zero value must match the active frame width.

height

Literal[active height] | 0

Optional; non-zero value must match the active frame height.

AudioChunk accepts 5 fields:

session_id

str

Must match SessionInit.session_id.

seq

uint64

Strictly monotonic increasing across chunks.

audio

bytes[pcm_s16le]

Signed 16-bit little-endian PCM; byte length must be even.

pts_ms

uint64

Presentation timestamp in milliseconds.

is_final

bool

true closes the speech segment and starts rendering.

Returns VideoResponse stream:

frame

bytes[h264_all_intra]

One H.264 all-Intra frame per response.

status

Literal["CLIP_START", "OK", "CLIP_END", "CANCELLED", "ERROR"]

CLIP_START and CLIP_END frames are marked as transition frames.

Result

Frames0

Render ms0

Total bytes0

Avg frame0

Frames

No clip service result yet.

Seq	PTS ms	Status	Transition	Bytes	Size

Raw JSON

{}