Call client.videos.create() to submit the prompt and start a video-generation job against the model deployment. Video generation is asynchronous: the initial response represents a job and contains properties such as its unique ID and current status rather than immediately returning the completed video. Microsoft’s official Python example creates the job by using client.videos.create(model=..., prompt=...).

The application must then poll the job. After waiting between requests, client.videos.retrieve(video.id) obtains the latest state of that specific job. Polling continues until the status becomes completed, failed, or cancelled. list would enumerate jobs rather than refresh the selected job, while download_content is used only after successful completion to retrieve the generated video file.

To comply with Contoso’s prohibition on API keys, the client should use a Microsoft Entra bearer-token provider. The OpenAI Python client accepts this provider through its api_key constructor parameter even though no static API key is used.

Study Guide alignment: design and implement video-generation solutions and integrate generative workflows through Foundry SDKs.