# Iniciar transmissão ao vivo

Inicia a transmissão ao vivo de um MP4 já enviado em um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e o serviço dele precisa suportar transmissão ao vivo. O `fileId` precisa se referir a um arquivo enviado como mídia de transmissão cujo upload foi concluído; qualquer outra coisa é rejeitada como inválida ou expirada.
- **Conclusão**: **aceito, não concluído.** A resposta apenas confirma que o serviço recebeu a solicitação. Consulte `/cloudphone/live/status` até que `liveStatus` seja `1`.
- **Observação**: a restrição de apenas MP4 é aplicada no envio do arquivo, não aqui.
- **Nova tentativa**: não há deduplicação; uma chamada repetida reemite o comando de início.

Erros de negócio documentados: `33300`, `33301`, `33401`, `33418`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudphone/live/start
Version: 2026-09-05

## Request fields (application/json):

  - `phoneId` (string, required)
    Cloud phone ID
    Example: 190000000000000001

  - `fileId` (string, required)
    ID of an uploaded MP4 live-streaming file (`uploadType=2`)
    Example: 820000000000000001

## Response 200:

  - `200` (unknown)
    Request processed; inspect `code` for the business result

## Response 200 fields (application/json):

  - `code` (integer, required)
    Business result code; `0` indicates success
    Example: 0

  - `msg` (string | null, required)
    Error message; null when successful
    Example: null

  - `requestId` (string, required)
    Request ID for troubleshooting
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (boolean, required)
    Whether the live-streaming operation succeeded