AsyncAPI channel · fal · fal Event-Driven APIs

{app_id}/realtime

Bi-directional WebSocket channel for realtime inference. Clients send one input message per generation step and receive zero or more partial or final output frames per step. The default path is `/realtime`; some apps expose custom paths configurable through the SDK `path` option. Messages are serialized as JSON by default and MAY be serialized as MessagePack (msgpack) when using the official SDKs,

Open source AsyncAPI → All fal channels fal provider profile
Provider: fal AsyncAPI: v2.6.0 Spec: fal Event-Driven APIs Operations: 2 Messages: 4

Channel address

{app_id}/realtime

Parameters

Operations

publish
sendRealtimeInput
Send an inference input frame.
receiveRealtimeOutput
Receive inference outputs and connection control messages.

Messages

RealtimeInput
Inference input frame. The accepted fields are defined by the OpenAPI schema of the target model — see the model's playground page on https://fal.ai/models for the canonical schema.
Content-Type: application/json
RealtimeResult
Inference output frame. Fields are model-specific; image-generation apps return an `images` array. The `request_id` echoes the inference invocation it corresponds to.
Content-Type: application/json
RealtimeError
Inference or framework-level error returned by the realtime runner.
Content-Type: application/json
RealtimeUnauthorized
Sent when the supplied credentials (proxy headers or JWT) cannot be verified. The connection is closed by the server after this frame.
Content-Type: application/json

About AsyncAPI

The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.

Browse every event-driven channel on the APIs.io network or compare with the broader Naftiko capability, Agent Skill, and MCP server surfaces of the same providers.