Get an OEmbedResponse from one of the providers configured in this
        consumer according to the resource url.

        Args:
            url: The url of the resource to get.
            format: Desired response format.
            **opt: Optional parameters to pass in the url to the provider.

        Returns:
            OEmbedResponse object.

def embed(self, url, format='json', **opt):
        '''
        Get an OEmbedResponse from one of the providers configured in this
        consumer according to the resource url.

        Args:
            url: The url of the resource to get.
            format: Desired response format.
            **opt: Optional parameters to pass in the url to the provider.

        Returns:
            OEmbedResponse object.
        '''
        if format not in ['json', 'xml']:
            raise OEmbedInvalidRequest('Format must be json or xml')
        opt['format'] = format
        return self._request(url, **opt)