[Unified Vision Service - Video Intelligence] API Review

[azure-sdk]

New API Review meeting has been requested.

Service Name: Unified Vision Service - Video Intelligence
Review Created By: Frederico Oliveira
Review Date: 05/16/2024 04:00 PM PT
Release Plan:
PR:
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: We are planning for June an API release for the new Video Analysis service. We will provide all the missing information up to 2 days before the meeting.

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Frederico Oliveira

Service Name: Unified Vision Service - Video Intelligence
Review Created By: Frederico Oliveira
Review Date: 05/16/2024 04:00 PM PT
Release Plan:
PR: #29109
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: We are planning for June an API release for the new Video Analysis service. We will provide all the missing information up to 2 days before the meeting.

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Frederico Oliveira

Service Name: Unified Vision Service - Video Intelligence
Review Created By: Frederico Oliveira
Review Date: 05/23/2024 04:00 PM PT
Release Plan:
PR: #29109
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: We are planning for June an API release for the new Video Analysis service. We will provide all the missing information up to 2 days before the meeting.

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[mikekistler]

Notes from API Review 5/23/24

• VideoAnalysis is a separate service from the rest of UnifiedVision. It will version independently and have it's own SDKs.
• Static path segments should be either kebab-case (preferred) or camelCase.
• URL Structure - there's a extra path segment, should try to remove this
• Use the api-version query parameter and remove version from the resource
• Recommend to avoid use of ISO durations -- it is not well-supported by our languages/SDKs
• Might want to be clear about how the URLs are used -- does it have to be a blob URL? Can it point elsewhere?
  • Might want to call it fileUrl or just url which is described by kind
  • But kind might not be enough to indicate the protocol to use
• The completion property in the request body will need to be revisited before GA -- it is problematic
  • And the naming of "resource"
• Should "preset" (or "domain") be within "input" ?

Will continue in another meeting to be scheduled.

[azure-sdk]

New API Review meeting has been requested.

Service Name: Unified Vision Service - Video Intelligence
Review Created By: Frederico Oliveira
Review Date: 06/06/2024 04:00 PM PT
Release Plan:
PR: #29109
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: Follow-up meeting.

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here