mirror of
https://github.com/wassname/openrouter-python-sdk-retry-errors.git
synced 2026-07-29 11:23:49 +08:00
github-actions[bot]GitHubspeakeasybotspeakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>Co-authored-by: speakeasybot <bot@speakeasyapi.dev> Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
1525 lines
66 KiB
Python
1525 lines
66 KiB
Python
"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
|
||
|
||
from .basesdk import BaseSDK
|
||
import httpx
|
||
from jsonpath import JSONPath
|
||
from openrouter import components, errors, operations, utils
|
||
from openrouter._hooks import HookContext
|
||
from openrouter.types import OptionalNullable, UNSET
|
||
from openrouter.utils import get_security_from_env
|
||
from openrouter.utils.unmarshal_json_response import unmarshal_json_response
|
||
from typing import Any, Awaitable, Dict, List, Mapping, Optional, Union
|
||
|
||
|
||
class Files(BaseSDK):
|
||
r"""Files endpoints"""
|
||
|
||
def list(
|
||
self,
|
||
*,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
limit: Optional[int] = None,
|
||
cursor: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> Optional[operations.ListFilesResponse]:
|
||
r"""List files
|
||
|
||
Lists files belonging to the workspace of the authenticating API key.
|
||
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param limit: Maximum number of files to return (1–1000).
|
||
:param cursor: Opaque pagination cursor from a previous response.
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.ListFilesRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
limit=limit,
|
||
cursor=cursor,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request(
|
||
method="GET",
|
||
path="/files",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=False,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.ListFilesGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = self.do_request(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="listFiles",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
def next_func() -> Optional[operations.ListFilesResponse]:
|
||
body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
|
||
|
||
next_cursor = JSONPath("$.cursor").parse(body)
|
||
|
||
if len(next_cursor) == 0:
|
||
return None
|
||
|
||
next_cursor = next_cursor[0]
|
||
if next_cursor is None or str(next_cursor).strip() == "":
|
||
return None
|
||
results = JSONPath("$.data").parse(body)
|
||
if len(results) == 0 or len(results[0]) == 0:
|
||
return None
|
||
|
||
return self.list(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
limit=limit,
|
||
cursor=next_cursor,
|
||
workspace_id=workspace_id,
|
||
retries=retries,
|
||
server_url=server_url,
|
||
timeout_ms=timeout_ms,
|
||
http_headers=http_headers,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return operations.ListFilesResponse(
|
||
result=unmarshal_json_response(components.FileListResponse, http_res),
|
||
next=next_func,
|
||
)
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
async def list_async(
|
||
self,
|
||
*,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
limit: Optional[int] = None,
|
||
cursor: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> Optional[operations.ListFilesResponse]:
|
||
r"""List files
|
||
|
||
Lists files belonging to the workspace of the authenticating API key.
|
||
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param limit: Maximum number of files to return (1–1000).
|
||
:param cursor: Opaque pagination cursor from a previous response.
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.ListFilesRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
limit=limit,
|
||
cursor=cursor,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request_async(
|
||
method="GET",
|
||
path="/files",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=False,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.ListFilesGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = await self.do_request_async(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="listFiles",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
def next_func() -> Awaitable[Optional[operations.ListFilesResponse]]:
|
||
body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
|
||
|
||
async def empty_result():
|
||
return None
|
||
|
||
next_cursor = JSONPath("$.cursor").parse(body)
|
||
|
||
if len(next_cursor) == 0:
|
||
return empty_result()
|
||
|
||
next_cursor = next_cursor[0]
|
||
if next_cursor is None or str(next_cursor).strip() == "":
|
||
return empty_result()
|
||
results = JSONPath("$.data").parse(body)
|
||
if len(results) == 0 or len(results[0]) == 0:
|
||
return empty_result()
|
||
|
||
return self.list_async(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
limit=limit,
|
||
cursor=next_cursor,
|
||
workspace_id=workspace_id,
|
||
retries=retries,
|
||
server_url=server_url,
|
||
timeout_ms=timeout_ms,
|
||
http_headers=http_headers,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return operations.ListFilesResponse(
|
||
result=unmarshal_json_response(components.FileListResponse, http_res),
|
||
next=next_func,
|
||
)
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
def upload(
|
||
self,
|
||
*,
|
||
file: Union[operations.UploadFileFile, operations.UploadFileFileTypedDict],
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileMetadata:
|
||
r"""Upload a file
|
||
|
||
Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.
|
||
|
||
:param file:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.UploadFileRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
workspace_id=workspace_id,
|
||
request_body=operations.UploadFileRequestBody(
|
||
file=utils.get_pydantic_model(file, operations.UploadFileFile),
|
||
),
|
||
)
|
||
|
||
req = self._build_request(
|
||
method="POST",
|
||
path="/files",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=True,
|
||
request_has_path_params=False,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.UploadFileGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
get_serialized_body=lambda: utils.serialize_request_body(
|
||
request.request_body,
|
||
False,
|
||
False,
|
||
"multipart",
|
||
operations.UploadFileRequestBody,
|
||
),
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = self.do_request(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="uploadFile",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileMetadata, http_res)
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "403", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.ForbiddenResponseErrorData, http_res
|
||
)
|
||
raise errors.ForbiddenResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "413", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.PayloadTooLargeResponseErrorData, http_res
|
||
)
|
||
raise errors.PayloadTooLargeResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
async def upload_async(
|
||
self,
|
||
*,
|
||
file: Union[operations.UploadFileFile, operations.UploadFileFileTypedDict],
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileMetadata:
|
||
r"""Upload a file
|
||
|
||
Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.
|
||
|
||
:param file:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.UploadFileRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
workspace_id=workspace_id,
|
||
request_body=operations.UploadFileRequestBody(
|
||
file=utils.get_pydantic_model(file, operations.UploadFileFile),
|
||
),
|
||
)
|
||
|
||
req = self._build_request_async(
|
||
method="POST",
|
||
path="/files",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=True,
|
||
request_has_path_params=False,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.UploadFileGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
get_serialized_body=lambda: utils.serialize_request_body(
|
||
request.request_body,
|
||
False,
|
||
False,
|
||
"multipart",
|
||
operations.UploadFileRequestBody,
|
||
),
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = await self.do_request_async(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="uploadFile",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileMetadata, http_res)
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "403", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.ForbiddenResponseErrorData, http_res
|
||
)
|
||
raise errors.ForbiddenResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "413", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.PayloadTooLargeResponseErrorData, http_res
|
||
)
|
||
raise errors.PayloadTooLargeResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
def delete(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileDeleteResponse:
|
||
r"""Delete a file
|
||
|
||
Deletes a file owned by the requesting workspace. Deletion is irreversible.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.DeleteFileRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request(
|
||
method="DELETE",
|
||
path="/files/{file_id}",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.DeleteFileGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = self.do_request(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="deleteFile",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileDeleteResponse, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
async def delete_async(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileDeleteResponse:
|
||
r"""Delete a file
|
||
|
||
Deletes a file owned by the requesting workspace. Deletion is irreversible.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.DeleteFileRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request_async(
|
||
method="DELETE",
|
||
path="/files/{file_id}",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.DeleteFileGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = await self.do_request_async(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="deleteFile",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileDeleteResponse, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
def retrieve(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileMetadata:
|
||
r"""Get file metadata
|
||
|
||
Retrieves metadata for a single file owned by the requesting workspace.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.GetFileMetadataRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request(
|
||
method="GET",
|
||
path="/files/{file_id}",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.GetFileMetadataGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = self.do_request(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="getFileMetadata",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileMetadata, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
async def retrieve_async(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> components.FileMetadata:
|
||
r"""Get file metadata
|
||
|
||
Retrieves metadata for a single file owned by the requesting workspace.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.GetFileMetadataRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request_async(
|
||
method="GET",
|
||
path="/files/{file_id}",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/json",
|
||
http_headers=http_headers,
|
||
_globals=operations.GetFileMetadataGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = await self.do_request_async(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="getFileMetadata",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/json"):
|
||
return unmarshal_json_response(components.FileMetadata, http_res)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res
|
||
)
|
||
raise errors.UnauthorizedResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res
|
||
)
|
||
raise errors.TooManyRequestsResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res
|
||
)
|
||
raise errors.InternalServerResponseError(response_data, http_res)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
raise errors.OpenRouterDefaultError("Unexpected response received", http_res)
|
||
|
||
def download(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> httpx.Response:
|
||
r"""Download file content
|
||
|
||
Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.DownloadFileContentRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request(
|
||
method="GET",
|
||
path="/files/{file_id}/content",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/octet-stream",
|
||
http_headers=http_headers,
|
||
_globals=operations.DownloadFileContentGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = self.do_request(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="downloadFileContent",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
stream=True,
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/octet-stream"):
|
||
return http_res
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res, http_res_text)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.UnauthorizedResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res, http_res_text)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.TooManyRequestsResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.InternalServerResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
http_res_text = utils.stream_to_text(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"Unexpected response received", http_res, http_res_text
|
||
)
|
||
|
||
async def download_async(
|
||
self,
|
||
*,
|
||
file_id: str,
|
||
http_referer: Optional[str] = None,
|
||
x_open_router_title: Optional[str] = None,
|
||
x_open_router_categories: Optional[str] = None,
|
||
workspace_id: Optional[str] = None,
|
||
retries: OptionalNullable[utils.RetryConfig] = UNSET,
|
||
server_url: Optional[str] = None,
|
||
timeout_ms: Optional[int] = None,
|
||
http_headers: Optional[Mapping[str, str]] = None,
|
||
) -> httpx.Response:
|
||
r"""Download file content
|
||
|
||
Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.
|
||
|
||
:param file_id:
|
||
:param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings.
|
||
This is used to track API usage per application.
|
||
|
||
:param x_open_router_title: The app display name allows you to customize how your app appears in OpenRouter's dashboard.
|
||
|
||
:param x_open_router_categories: Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.
|
||
|
||
:param workspace_id: Workspace to scope the request to. Defaults to the caller’s default workspace.
|
||
:param retries: Override the default retry configuration for this method
|
||
:param server_url: Override the default server URL for this method
|
||
:param timeout_ms: Override the default request timeout configuration for this method in milliseconds
|
||
:param http_headers: Additional headers to set or replace on requests.
|
||
"""
|
||
base_url = None
|
||
url_variables = None
|
||
if timeout_ms is None:
|
||
timeout_ms = self.sdk_configuration.timeout_ms
|
||
|
||
if server_url is not None:
|
||
base_url = server_url
|
||
else:
|
||
base_url = self._get_url(base_url, url_variables)
|
||
|
||
request = operations.DownloadFileContentRequest(
|
||
http_referer=http_referer,
|
||
x_open_router_title=x_open_router_title,
|
||
x_open_router_categories=x_open_router_categories,
|
||
file_id=file_id,
|
||
workspace_id=workspace_id,
|
||
)
|
||
|
||
req = self._build_request_async(
|
||
method="GET",
|
||
path="/files/{file_id}/content",
|
||
base_url=base_url,
|
||
url_variables=url_variables,
|
||
request=request,
|
||
request_body_required=False,
|
||
request_has_path_params=True,
|
||
request_has_query_params=True,
|
||
user_agent_header="user-agent",
|
||
accept_header_value="application/octet-stream",
|
||
http_headers=http_headers,
|
||
_globals=operations.DownloadFileContentGlobals(
|
||
http_referer=self.sdk_configuration.globals.http_referer,
|
||
x_open_router_title=self.sdk_configuration.globals.x_open_router_title,
|
||
x_open_router_categories=self.sdk_configuration.globals.x_open_router_categories,
|
||
),
|
||
security=self.sdk_configuration.security,
|
||
allow_empty_value=None,
|
||
timeout_ms=timeout_ms,
|
||
)
|
||
|
||
if retries == UNSET:
|
||
if self.sdk_configuration.retry_config is not UNSET:
|
||
retries = self.sdk_configuration.retry_config
|
||
else:
|
||
retries = utils.RetryConfig(
|
||
"backoff", utils.BackoffStrategy(500, 60000, 1.5, 3600000), True
|
||
)
|
||
|
||
retry_config = None
|
||
if isinstance(retries, utils.RetryConfig):
|
||
retry_config = (retries, ["5XX"])
|
||
|
||
http_res = await self.do_request_async(
|
||
hook_ctx=HookContext(
|
||
config=self.sdk_configuration,
|
||
base_url=base_url or "",
|
||
operation_id="downloadFileContent",
|
||
oauth2_scopes=None,
|
||
security_source=get_security_from_env(
|
||
self.sdk_configuration.security, components.Security
|
||
),
|
||
tags=["Files"],
|
||
extensions=None,
|
||
),
|
||
request=req,
|
||
is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
|
||
stream=True,
|
||
retry_config=retry_config,
|
||
)
|
||
|
||
response_data: Any = None
|
||
if utils.match_response(http_res, "200", "application/octet-stream"):
|
||
return http_res
|
||
if utils.match_response(http_res, "400", "application/json"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.BadRequestResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.BadRequestResponseError(response_data, http_res, http_res_text)
|
||
if utils.match_response(http_res, "401", "application/json"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.UnauthorizedResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.UnauthorizedResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "404", "application/json"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.NotFoundResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.NotFoundResponseError(response_data, http_res, http_res_text)
|
||
if utils.match_response(http_res, "429", "application/json"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.TooManyRequestsResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.TooManyRequestsResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "500", "application/json"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
response_data = unmarshal_json_response(
|
||
errors.InternalServerResponseErrorData, http_res, http_res_text
|
||
)
|
||
raise errors.InternalServerResponseError(
|
||
response_data, http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "4XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
if utils.match_response(http_res, "5XX", "*"):
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"API error occurred", http_res, http_res_text
|
||
)
|
||
|
||
http_res_text = await utils.stream_to_text_async(http_res)
|
||
raise errors.OpenRouterDefaultError(
|
||
"Unexpected response received", http_res, http_res_text
|
||
)
|