diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock index 57e7f7038..4fb69ee48 100644 --- a/.speakeasy/gen.lock +++ b/.speakeasy/gen.lock @@ -1,19 +1,19 @@ lockVersion: 2.0.0 id: c48cf606-fb42-4a45-9c23-8f0555307828 management: - docChecksum: 7b326991ba70a8a48c576cf6bf36dc6c + docChecksum: 30567c425d240802631762506228f8ef docVersion: 1.0.0 speakeasyVersion: 1.803.2 generationVersion: 2.950.13 - releaseVersion: 1.3.170 - configChecksum: 990eaedd546b685ababbd0717166ab92 + releaseVersion: 1.3.171 + configChecksum: ddb32bd4e2b8a710a5724c95f74c9178 repoURL: https://github.com/OpenRouterTeam/python-sdk.git installationURL: https://github.com/OpenRouterTeam/python-sdk.git published: true persistentEdits: - generation_id: 69e6761f-bc28-4415-b052-482fbb106c90 - pristine_commit_hash: 741529e4b9021d7ccde61b0ea7ba94f09f9fc7fe - pristine_tree_hash: 84ce71d677f19c37587e79ad54585c3db06883ac + generation_id: 8f603718-2d74-46a4-8de3-253f2cbea57d + pristine_commit_hash: eb79adce5125c82f470d162346517bb4969878a2 + pristine_tree_hash: 414af1b5eb147165659d5fe3d63d08256f91be78 features: python: acceptHeaders: 3.0.0 @@ -2370,6 +2370,10 @@ trackedFiles: id: "137661546600" last_write_checksum: sha1:52a29f08a47bd145d257e91179c8eabdefe3c1de pristine_git_object: 6354befd490009d58b64685af835349db22c7492 + docs/components/code.mdx: + id: 1cc125f1dfa9 + last_write_checksum: sha1:b4d938a194de1393a6284379c0afcaafd216cb68 + pristine_git_object: cc12f8a2431ca1d725c5be56ec08b36cf118faab docs/components/codeenum.mdx: id: 9b9b999fccff last_write_checksum: sha1:66f796282837dc99c70f16954d3dd441947040d2 @@ -7698,6 +7702,10 @@ trackedFiles: id: 3c4fe7ccb317 last_write_checksum: sha1:62c6558f6d82310cd4238271a07372d51a2ffdf7 pristine_git_object: aa7c89233d761c71c471d4f9ee808e648e683fcf + docs/components/responsesbadrequestresponseerrordata.mdx: + id: 3c69e8a7ccae + last_write_checksum: sha1:6740787193a5ef2ca33b52109b388e3dfc61367e + pristine_git_object: 7a781ae1ba333185a5fd94840aa26f84c2ac39f8 docs/components/responsesrequest.mdx: id: 0dbcef40a4b1 last_write_checksum: sha1:5e2b69aa6866361fc1f9d1269bc85565af5fd3c2 @@ -9438,6 +9446,10 @@ trackedFiles: id: d6a4789cc5eb last_write_checksum: sha1:cb0850de4183d057d8999a2a4515ee46e4bdf5a7 pristine_git_object: a8a7ac252ae5ccf1a897dd90ef980c0fa50662a6 + docs/errors/responsesbadrequestresponseerror.mdx: + id: 5de7941cc583 + last_write_checksum: sha1:f6c2d66617f901760cfcb4dd92be435c10b3f792 + pristine_git_object: 65f77b182e6af1bf7ba8fc225def5e8a70eee21a docs/errors/serviceunavailableresponseerror.mdx: id: a3536716f3f6 last_write_checksum: sha1:e279b9b55443729dc08a58f069e2e9be63ad2623 @@ -11476,8 +11488,8 @@ trackedFiles: pristine_git_object: 46fe09f0c09e01c11b8b88fc5265802ac48ee05d docs/sdks/betaresponses/README.mdx: id: 8a1e987c9840 - last_write_checksum: sha1:0d8d0c1f105a2e63d9c36708dce2bb947f400986 - pristine_git_object: d8a2042d4ec07f41bb5bf9d08f9cf8e9dc637ca9 + last_write_checksum: sha1:b6c877d4e4d77e6ea6ce093fbb4964b18e87fa48 + pristine_git_object: 9874b1be23d8dbf7fd2d2d913a5900ec717a2323 docs/sdks/byok/README.mdx: id: 17792f3b180d last_write_checksum: sha1:d1591e36b066c16a0af88856ff54759f7dfab3ab @@ -11580,8 +11592,8 @@ trackedFiles: pristine_git_object: 4e10c25ed694e617695e7fc6192b7b25302977d6 docs/sdks/responses/README.mdx: id: abab319e080e - last_write_checksum: sha1:d722c7f399ec4c0e637e5f73805d576d438c4710 - pristine_git_object: c9dd55e7c38c9d1e1ad4ef7ce4e3d1d7e46d57a2 + last_write_checksum: sha1:05f69bace042c46e06427268f8579cf2096531ae + pristine_git_object: 65eb984d913d1196f223e1c2f8004891d1a53058 docs/sdks/scim/README.mdx: id: fd6d8a91a053 last_write_checksum: sha1:28c02b55a629845b4912e9eac168cfc0cb7eb785 @@ -11620,8 +11632,8 @@ trackedFiles: pristine_git_object: 3e38f1a929f7d6b1d6de74604aa87e3d8f010544 pyproject.toml: id: 5d07e7d72637 - last_write_checksum: sha1:6fd972a2de80493fb50b225b4b2a3c3dd40644cd - pristine_git_object: ca7074d884098d18f06262f84d9ffad6715ea33d + last_write_checksum: sha1:1fedb72c7a7746bc6820bfc15d27da4668a25d38 + pristine_git_object: d5e097456fcbe579ec290d83033603e77b733dd9 scripts/prepare_readme.py: id: e0c5957a6035 last_write_checksum: sha1:77f44b60b98bc126557ec27391f91dfba764bb54 @@ -11648,8 +11660,8 @@ trackedFiles: pristine_git_object: 86713cfea633e09d33b3d4e65281071fe20e6137 src/openrouter/_version.py: id: d8d15ad6c586 - last_write_checksum: sha1:c1b7078545826eb3dfe078120fe142ed30e97ea1 - pristine_git_object: 5931b7f6361978af77c74b151ac4d6bb3d4dbbf2 + last_write_checksum: sha1:54a93a3b40a308a571cbb926dd7a4340c573ded4 + pristine_git_object: 015b9fc84d77cd77a66356cfe7b8fb05de0931a3 src/openrouter/alpha.py: id: 306c4d93308d last_write_checksum: sha1:80cc0f39649445431cc2247ed0e0765438467766 @@ -11680,8 +11692,8 @@ trackedFiles: pristine_git_object: aa95a65cf560fd7edb0c3c6f5fed707ca5015da3 src/openrouter/beta_responses.py: id: 001eaf848bf1 - last_write_checksum: sha1:303e4e92f493cb7156eeddc41827549626445451 - pristine_git_object: 7f694159275ebd1a7badbce458671d0f79456fe9 + last_write_checksum: sha1:aeb93517b3625f0de7f2f7d4303d9e923baad5b1 + pristine_git_object: 098495886511368599e696e6b5c4e86330b68ace src/openrouter/byok.py: id: bec352462ae1 last_write_checksum: sha1:7dcf7307ab168b9abe88c4a534c70d213d4a445a @@ -11696,8 +11708,8 @@ trackedFiles: pristine_git_object: ad3d247954547814054c01989a2dff3d12b3e4e1 src/openrouter/components/__init__.py: id: 81754e97b3f4 - last_write_checksum: sha1:453ee1682acc4516d475fc97334aef8cceae2e7c - pristine_git_object: 35c701ac061bb16ce29446f4f972cc402e5e9d64 + last_write_checksum: sha1:1e5e989da812bce6bb2832f209b3dd4072ca253b + pristine_git_object: 0f5c732d00c70b143a6ddf64bd045eceb9546cff src/openrouter/components/aabenchmarkentry.py: id: e2e0f0b48c82 last_write_checksum: sha1:fab4d9a24d2cea937bb749d46c5f83941e99d65c @@ -14790,6 +14802,10 @@ trackedFiles: id: cbc203c3ff40 last_write_checksum: sha1:c0c6ff17b402f0cbaf8d58add175f1026b0a4097 pristine_git_object: 900bf08ec940565a8cbf55712a437775db00ca46 + src/openrouter/components/responsesbadrequestresponseerrordata.py: + id: 076f3c78aa58 + last_write_checksum: sha1:c1f1208da12840aafa9c6f24d355862808e91e80 + pristine_git_object: e3f4b083aca1fd072ef8655b14160b20b9b36105 src/openrouter/components/responsesrequest.py: id: 8c850080ec5d last_write_checksum: sha1:9d83b013b38cb11f441fd47c479290762910d303 @@ -15528,8 +15544,8 @@ trackedFiles: pristine_git_object: 6597bc3d049c7cfcd9c192be377926a10174a5f3 src/openrouter/errors/__init__.py: id: 366154d0d60a - last_write_checksum: sha1:2bf92aa2923c6564ce5b91ae5c27e95257fe0f19 - pristine_git_object: 0159d3af1415d9c59412b32971cc1e9ba6bbe2e3 + last_write_checksum: sha1:6fafacd44c5292a1e912f303f772489ddcf2d58b + pristine_git_object: 1c1e5eda3c2004a0f165cf3752117523a44ec1bb src/openrouter/errors/badgatewayresponse_error.py: id: 818c3605ce23 last_write_checksum: sha1:f0307bff4a47f950c514d7d47de5690cac871bbb @@ -15618,6 +15634,10 @@ trackedFiles: id: 74f87b9d42d2 last_write_checksum: sha1:98de1308cf09289a6e4ed41ee029cc94004147dd pristine_git_object: fb025fdc0c8ab782635fd33dddd925c93385dbc9 + src/openrouter/errors/responsesbadrequestresponse_error.py: + id: 3047c36da199 + last_write_checksum: sha1:b64c57555298e22e07a5ea41877492b9d9318997 + pristine_git_object: fbf79ff44c51d4c357a0263368ec615404f741ae src/openrouter/errors/responsevalidationerror.py: id: 861959e3671e last_write_checksum: sha1:96842d22bdaacde74bc581692af0230b4aa2684c @@ -16400,8 +16420,8 @@ trackedFiles: pristine_git_object: 9db3cc719bd343ee7be0183d0c87b50c29e5eb31 src/openrouter/responses.py: id: f2108fb635e1 - last_write_checksum: sha1:e7412503a1fb94bd89d44158140aafa41ac0ad53 - pristine_git_object: 369de7f774ceca3150bd97de77efd91f5bf08142 + last_write_checksum: sha1:73d3705cb6a5e35e621e1541d2a89eaf2041d1e1 + pristine_git_object: 6583a0b59f3ede8c72897bb922c1f85de280e8e0 src/openrouter/scim.py: id: 351afd6b616e last_write_checksum: sha1:4c9a81e177e1dbc246e0955e90365d653d2ba876 @@ -16539,7 +16559,7 @@ examples: "200": application/json: {"completed_at": 1704067210, "created_at": 1704067200, "error": null, "frequency_penalty": null, "id": "resp-abc123", "incomplete_details": null, "instructions": null, "metadata": null, "model": "gpt-4", "object": "response", "output": [{"content": [{"text": "Hello! How can I help you today?", "type": "output_text"}], "id": "msg-abc123", "role": "assistant", "type": "message"}], "parallel_tool_calls": true, "presence_penalty": null, "status": "completed", "temperature": null, "tool_choice": "auto", "tools": [], "top_p": null} "400": - application/json: {"error": {"code": 400, "message": "Invalid request parameters"}} + application/json: {"error": {"code": "invalid_prompt", "message": "Invalid Responses API request"}} "401": application/json: {"error": {"code": 401, "message": "Missing Authentication header"}} "402": @@ -16578,6 +16598,18 @@ examples: responses: "403": application/json: {"error": {"code": 403, "message": "Only management keys can perform this operation"}} + invalid-parameters: + requestBody: + application/json: {"service_tier": "auto", "store": false, "stream": false} + responses: + "400": + application/json: {"error": {"code": 400, "message": "Invalid request parameters"}} + invalid-request-body: + requestBody: + application/json: {"service_tier": "auto", "store": false, "stream": false} + responses: + "400": + application/json: {"error": {"code": "invalid_prompt", "message": "Invalid Responses API request"}} getUserActivity: speakeasy-default-get-user-activity: responses: @@ -21609,4 +21641,3 @@ examples: "500": application/json: {"error": {"code": 500, "message": "Internal Server Error"}} examplesVersion: 1.0.2 -releaseNotes: "## Python SDK Changes:\n* `open_router.batch.create_batches()`: `response.results[].response.body.union(OpenResponsesResult).output[].union(openrouter:tool_search).catalog_index_note` **Added**\n* `open_router.batch.get_batches()`: `response.results[].response.body.union(OpenResponsesResult).output[].union(openrouter:tool_search).catalog_index_note` **Added**\n* `open_router.observability.list()`: `response.data[].union(otel-collector).config` **Changed**\n* `open_router.observability.create()`: `response.data.union(otel-collector).config` **Changed**\n* `open_router.observability.get()`: `response.data.union(otel-collector).config` **Changed**\n* `open_router.observability.update()`: `response.data.union(otel-collector).config` **Changed**\n* `open_router.presets.create_presets_responses()`: \n * `request.input.union(Array<>)[].union(OutputToolSearchServerToolItem).catalog_index_note` **Added**\n" diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml index ba3869ab8..682f7c893 100644 --- a/.speakeasy/gen.yaml +++ b/.speakeasy/gen.yaml @@ -37,7 +37,7 @@ generation: documentation: mintlify preApplyUnionDiscriminators: true python: - version: 1.3.170 + version: 1.3.171 additionalDependencies: dev: pytest: '>=8.3' diff --git a/.speakeasy/out.openapi.yaml b/.speakeasy/out.openapi.yaml index 7a814e6df..3e8387c45 100644 --- a/.speakeasy/out.openapi.yaml +++ b/.speakeasy/out.openapi.yaml @@ -32495,6 +32495,61 @@ components: - 'type' - 'text' type: 'object' + ResponsesBadRequestResponse: + description: 'Bad Request - Invalid request parameters or malformed input. Request-shape validation failures carry a Responses API string code (e.g. `invalid_prompt`) with details in the top-level `metadata`; all other failures carry the integer HTTP status.' + example: + error: + code: 'invalid_prompt' + message: 'Invalid Responses API request' + metadata: + raw: '[{"code":"invalid_value","path":["input",0,"type"]}]' + properties: + error: + $ref: '#/components/schemas/ResponsesBadRequestResponseErrorData' + metadata: + additionalProperties: + type: 'string' + description: 'Validation details for string-coded errors; `raw` holds the serialized schema issues' + example: + raw: '[{"code":"invalid_value","path":["input",0,"type"]}]' + type: + - 'object' + - 'null' + openrouter_metadata: + additionalProperties: {} + type: + - 'object' + - 'null' + user_id: + type: + - 'string' + - 'null' + required: + - 'error' + type: 'object' + ResponsesBadRequestResponseErrorData: + description: 'Error data for ResponsesBadRequestResponse' + example: + code: 'invalid_prompt' + message: 'Invalid Responses API request' + properties: + code: + anyOf: + - type: 'integer' + - type: 'string' + description: 'Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation' + example: 'invalid_prompt' + message: + type: 'string' + metadata: + additionalProperties: {} + type: + - 'object' + - 'null' + required: + - 'code' + - 'message' + type: 'object' ResponsesErrorField: description: 'Error information returned from the API' example: @@ -57705,13 +57760,24 @@ paths: '400': content: application/json: - example: - error: - code: 400 - message: 'Invalid request parameters' + examples: + invalid-parameters: + summary: 'Invalid request parameters' + value: + error: + code: 400 + message: 'Invalid request parameters' + invalid-request-body: + summary: 'Request body failed Responses API validation' + value: + error: + code: 'invalid_prompt' + message: 'Invalid Responses API request' + metadata: + raw: '[{"code":"invalid_value","path":["input",0,"type"]}]' schema: - $ref: '#/components/schemas/BadRequestResponse' - description: 'Bad Request - Invalid request parameters or malformed input' + $ref: '#/components/schemas/ResponsesBadRequestResponse' + description: 'Bad Request - Invalid request parameters or malformed input. Request-shape validation failures carry a Responses API string code (e.g. `invalid_prompt`) with details in the top-level `metadata`; all other failures carry the integer HTTP status.' '401': content: application/json: diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock index 4c527cc6a..4027b906f 100644 --- a/.speakeasy/workflow.lock +++ b/.speakeasy/workflow.lock @@ -2,8 +2,8 @@ speakeasyVersion: 1.803.2 sources: OpenRouter API: sourceNamespace: open-router-chat-completions-api - sourceRevisionDigest: sha256:6885d2855f3ae66c49062c150518080abc52f39a1b03c89930fc7f79b6c4aa25 - sourceBlobDigest: sha256:6334d0f3405226eda109b1d7df7ba961b55581a54363615c714c150e67fa8a4a + sourceRevisionDigest: sha256:2da9790d04eb9873088b59c89e7456494fc51041d339e057428ccf326dabe8e5 + sourceBlobDigest: sha256:fe041198672377cdbae02cfb2a1342e1d96dc5de89fb2338946809ade321fea6 tags: - latest - 1.0.0 @@ -11,10 +11,10 @@ targets: open-router: source: OpenRouter API sourceNamespace: open-router-chat-completions-api - sourceRevisionDigest: sha256:6885d2855f3ae66c49062c150518080abc52f39a1b03c89930fc7f79b6c4aa25 - sourceBlobDigest: sha256:6334d0f3405226eda109b1d7df7ba961b55581a54363615c714c150e67fa8a4a + sourceRevisionDigest: sha256:2da9790d04eb9873088b59c89e7456494fc51041d339e057428ccf326dabe8e5 + sourceBlobDigest: sha256:fe041198672377cdbae02cfb2a1342e1d96dc5de89fb2338946809ade321fea6 codeSamplesNamespace: open-router-python-code-samples - codeSamplesRevisionDigest: sha256:7b2a6716f9d8b9e6e43e0007aaeb98c1d7a5dd014fcc896f367d6e475d5669a2 + codeSamplesRevisionDigest: sha256:b23baa9166ec8ee272754fd101966676f619c29ab42423aafeae165f44f8f35e workflow: workflowVersion: 1.0.0 speakeasyVersion: 1.803.2 diff --git a/RELEASES.md b/RELEASES.md index e1ea47fa6..c0a081828 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -4469,4 +4469,14 @@ Based on: ### Generated - [python v1.3.170] . ### Releases -- [PyPI v1.3.170] https://pypi.org/project/openrouter/1.3.170 - . \ No newline at end of file +- [PyPI v1.3.170] https://pypi.org/project/openrouter/1.3.170 - . + +## 2026-11-12 17:52:57 +### Changes +Based on: +- OpenAPI Doc +- Speakeasy CLI 1.803.2 (2.950.13) https://github.com/speakeasy-api/speakeasy +### Generated +- [python v1.3.171] . +### Releases +- [PyPI v1.3.171] https://pypi.org/project/openrouter/1.3.171 - . \ No newline at end of file diff --git a/docs/components/code.mdx b/docs/components/code.mdx new file mode 100644 index 000000000..cc12f8a24 --- /dev/null +++ b/docs/components/code.mdx @@ -0,0 +1,21 @@ +--- +title: "Code" +--- + +Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation + + +## Supported Types + +### `int` + +```python +value: int = /* values here */ +``` + +### `str` + +```python +value: str = /* values here */ +``` + diff --git a/docs/components/responsesbadrequestresponseerrordata.mdx b/docs/components/responsesbadrequestresponseerrordata.mdx new file mode 100644 index 000000000..7a781ae1b --- /dev/null +++ b/docs/components/responsesbadrequestresponseerrordata.mdx @@ -0,0 +1,14 @@ +--- +title: "ResponsesBadRequestResponseErrorData" +--- + +Error data for ResponsesBadRequestResponse + + +## Fields + +| Field | Type | Required | Description | Example | +| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | +| `code` | [components.Code](../components/code.mdx) | ✔️ | Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation | invalid_prompt | +| `message` | *str* | ✔️ | N/A | | +| `metadata` | Dict[str, *Any*] | ➖ | N/A | | \ No newline at end of file diff --git a/docs/errors/responsesbadrequestresponseerror.mdx b/docs/errors/responsesbadrequestresponseerror.mdx new file mode 100644 index 000000000..65f77b182 --- /dev/null +++ b/docs/errors/responsesbadrequestresponseerror.mdx @@ -0,0 +1,15 @@ +--- +title: "ResponsesBadRequestResponseError" +--- + +Bad Request - Invalid request parameters or malformed input. Request-shape validation failures carry a Responses API string code (e.g. `invalid_prompt`) with details in the top-level `metadata`; all other failures carry the integer HTTP status. + + +## Fields + +| Field | Type | Required | Description | Example | +| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | +| `error` | [components.ResponsesBadRequestResponseErrorData](../components/responsesbadrequestresponseerrordata.mdx) | ✔️ | Error data for ResponsesBadRequestResponse | \{
"code": "invalid_prompt",
"message": "Invalid Responses API request"
} | +| `metadata` | Dict[str, *str*] | ➖ | Validation details for string-coded errors; `raw` holds the serialized schema issues | \{
"raw": "[\{\"code\":\"invalid_value\",\"path\":[\"input\",0,\"type\"]}]"
} | +| `openrouter_metadata` | Dict[str, *Any*] | ➖ | N/A | | +| `user_id` | *OptionalNullable[str]* | ➖ | N/A | | \ No newline at end of file diff --git a/docs/sdks/betaresponses/README.mdx b/docs/sdks/betaresponses/README.mdx index d8a2042d4..9874b1be2 100644 --- a/docs/sdks/betaresponses/README.mdx +++ b/docs/sdks/betaresponses/README.mdx @@ -44,6 +44,50 @@ from openrouter import OpenRouter import os +with OpenRouter( + http_referer="", + x_open_router_title="", + x_open_router_categories="", + api_key=os.getenv("OPENROUTER_API_KEY", ""), +) as open_router: + + res = open_router.beta.responses.send(service_tier="auto", stream=False) + + with res as event_stream: + for event in event_stream: + # handle event + print(event, flush=True) + +``` +### Example Usage: invalid-parameters + +```python +from openrouter import OpenRouter +import os + + +with OpenRouter( + http_referer="", + x_open_router_title="", + x_open_router_categories="", + api_key=os.getenv("OPENROUTER_API_KEY", ""), +) as open_router: + + res = open_router.beta.responses.send(service_tier="auto", stream=False) + + with res as event_stream: + for event in event_stream: + # handle event + print(event, flush=True) + +``` +### Example Usage: invalid-request-body + +```python +from openrouter import OpenRouter +import os + + with OpenRouter( http_referer="", x_open_router_title="", @@ -119,7 +163,7 @@ with OpenRouter( | Error Type | Status Code | Content Type | | --------------------------------------- | --------------------------------------- | --------------------------------------- | -| errors.BadRequestResponseError | 400 | application/json | +| errors.ResponsesBadRequestResponseError | 400 | application/json | | errors.UnauthorizedResponseError | 401 | application/json | | errors.PaymentRequiredResponseError | 402 | application/json | | errors.ForbiddenResponseError | 403 | application/json | diff --git a/docs/sdks/responses/README.mdx b/docs/sdks/responses/README.mdx index c9dd55e7c..65eb984d9 100644 --- a/docs/sdks/responses/README.mdx +++ b/docs/sdks/responses/README.mdx @@ -44,6 +44,50 @@ from openrouter import OpenRouter import os +with OpenRouter( + http_referer="", + x_open_router_title="", + x_open_router_categories="", + api_key=os.getenv("OPENROUTER_API_KEY", ""), +) as open_router: + + res = open_router.responses.send(service_tier="auto", stream=False) + + with res as event_stream: + for event in event_stream: + # handle event + print(event, flush=True) + +``` +### Example Usage: invalid-parameters + +```python +from openrouter import OpenRouter +import os + + +with OpenRouter( + http_referer="", + x_open_router_title="", + x_open_router_categories="", + api_key=os.getenv("OPENROUTER_API_KEY", ""), +) as open_router: + + res = open_router.responses.send(service_tier="auto", stream=False) + + with res as event_stream: + for event in event_stream: + # handle event + print(event, flush=True) + +``` +### Example Usage: invalid-request-body + +```python +from openrouter import OpenRouter +import os + + with OpenRouter( http_referer="", x_open_router_title="", @@ -119,7 +163,7 @@ with OpenRouter( | Error Type | Status Code | Content Type | | --------------------------------------- | --------------------------------------- | --------------------------------------- | -| errors.BadRequestResponseError | 400 | application/json | +| errors.ResponsesBadRequestResponseError | 400 | application/json | | errors.UnauthorizedResponseError | 401 | application/json | | errors.PaymentRequiredResponseError | 402 | application/json | | errors.ForbiddenResponseError | 403 | application/json | diff --git a/pyproject.toml b/pyproject.toml index ca7074d88..d5e097456 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "openrouter" -version = "1.3.170" +version = "1.3.171" description = "Official Python Client SDK for OpenRouter." authors = [{ name = "OpenRouter" },] readme = "README-PYPI.md" diff --git a/src/openrouter/_version.py b/src/openrouter/_version.py index 5931b7f63..015b9fc84 100644 --- a/src/openrouter/_version.py +++ b/src/openrouter/_version.py @@ -3,10 +3,10 @@ import importlib.metadata __title__: str = "openrouter" -__version__: str = "1.3.170" +__version__: str = "1.3.171" __openapi_doc_version__: str = "1.0.0" __gen_version__: str = "2.950.13" -__user_agent__: str = "speakeasy-sdk/python 1.3.170 2.950.13 1.0.0 openrouter" +__user_agent__: str = "speakeasy-sdk/python 1.3.171 2.950.13 1.0.0 openrouter" try: if __package__ is not None: diff --git a/src/openrouter/beta_responses.py b/src/openrouter/beta_responses.py index 7f6941592..098495886 100644 --- a/src/openrouter/beta_responses.py +++ b/src/openrouter/beta_responses.py @@ -917,9 +917,11 @@ def send( 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 + errors.ResponsesBadRequestResponseErrorData, http_res, http_res_text + ) + raise errors.ResponsesBadRequestResponseError( + response_data, 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( @@ -1929,9 +1931,11 @@ async def send_async( 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 + errors.ResponsesBadRequestResponseErrorData, http_res, http_res_text + ) + raise errors.ResponsesBadRequestResponseError( + response_data, 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( diff --git a/src/openrouter/components/__init__.py b/src/openrouter/components/__init__.py index 35c701ac0..0f5c732d0 100644 --- a/src/openrouter/components/__init__.py +++ b/src/openrouter/components/__init__.py @@ -4294,6 +4294,12 @@ ResponseOutputTextType, ResponseOutputTextTypedDict, ) + from .responsesbadrequestresponseerrordata import ( + Code, + CodeTypedDict, + ResponsesBadRequestResponseErrorData, + ResponsesBadRequestResponseErrorDataTypedDict, + ) from .responsesrequest import ( ReasoningConfig, ReasoningConfigTypedDict, @@ -5990,6 +5996,7 @@ "ClearToolInputsTypedDict", "ClientClosedRequestResponseErrorData", "ClientClosedRequestResponseErrorDataTypedDict", + "Code", "CodeEnum", "CodeInterpreterCallCodeDeltaEvent", "CodeInterpreterCallCodeDeltaEventType", @@ -6017,6 +6024,7 @@ "CodeInterpreterLogsOutputTypedDict", "CodeInterpreterServerTool", "CodeInterpreterServerToolTypedDict", + "CodeTypedDict", "CodexLocalShellTool", "CodexLocalShellToolType", "CodexLocalShellToolTypedDict", @@ -8097,6 +8105,8 @@ "ResponseOutputTextTopLogprobTypedDict", "ResponseOutputTextType", "ResponseOutputTextTypedDict", + "ResponsesBadRequestResponseErrorData", + "ResponsesBadRequestResponseErrorDataTypedDict", "ResponsesRequest", "ResponsesRequestAccessPrograms", "ResponsesRequestAccessProgramsTypedDict", @@ -11953,6 +11963,10 @@ "ResponseOutputTextTopLogprobTypedDict": ".responseoutputtext", "ResponseOutputTextType": ".responseoutputtext", "ResponseOutputTextTypedDict": ".responseoutputtext", + "Code": ".responsesbadrequestresponseerrordata", + "CodeTypedDict": ".responsesbadrequestresponseerrordata", + "ResponsesBadRequestResponseErrorData": ".responsesbadrequestresponseerrordata", + "ResponsesBadRequestResponseErrorDataTypedDict": ".responsesbadrequestresponseerrordata", "ReasoningConfig": ".responsesrequest", "ReasoningConfigTypedDict": ".responsesrequest", "ResponsesRequest": ".responsesrequest", diff --git a/src/openrouter/components/responsesbadrequestresponseerrordata.py b/src/openrouter/components/responsesbadrequestresponseerrordata.py new file mode 100644 index 000000000..e3f4b083a --- /dev/null +++ b/src/openrouter/components/responsesbadrequestresponseerrordata.py @@ -0,0 +1,66 @@ +"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.""" + +from __future__ import annotations +from openrouter.types import ( + BaseModel, + Nullable, + OptionalNullable, + UNSET, + UNSET_SENTINEL, +) +from pydantic import model_serializer +from typing import Any, Dict, Union +from typing_extensions import NotRequired, TypeAliasType, TypedDict + + +CodeTypedDict = TypeAliasType("CodeTypedDict", Union[int, str]) +r"""Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation""" + + +Code = TypeAliasType("Code", Union[int, str]) +r"""Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation""" + + +class ResponsesBadRequestResponseErrorDataTypedDict(TypedDict): + r"""Error data for ResponsesBadRequestResponse""" + + code: CodeTypedDict + r"""Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation""" + message: str + metadata: NotRequired[Nullable[Dict[str, Any]]] + + +class ResponsesBadRequestResponseErrorData(BaseModel): + r"""Error data for ResponsesBadRequestResponse""" + + code: Code + r"""Integer HTTP status, or a Responses API error code string (e.g. `invalid_prompt`) when the request body fails validation""" + + message: str + + metadata: OptionalNullable[Dict[str, Any]] = UNSET + + @model_serializer(mode="wrap") + def serialize_model(self, handler): + optional_fields = set(["metadata"]) + nullable_fields = set(["metadata"]) + serialized = handler(self) + m = {} + + for n, f in type(self).model_fields.items(): + k = f.alias or n + val = serialized.get(k, serialized.get(n)) + is_nullable_and_explicitly_set = ( + k in nullable_fields + and (self.__pydantic_fields_set__.intersection({n})) # pylint: disable=no-member + ) + + if val != UNSET_SENTINEL: + if ( + val is not None + or k not in optional_fields + or is_nullable_and_explicitly_set + ): + m[k] = val + + return m diff --git a/src/openrouter/errors/__init__.py b/src/openrouter/errors/__init__.py index 0159d3af1..1c1e5eda3 100644 --- a/src/openrouter/errors/__init__.py +++ b/src/openrouter/errors/__init__.py @@ -77,6 +77,10 @@ RequestTimeoutResponseError, RequestTimeoutResponseErrorData, ) + from .responsesbadrequestresponse_error import ( + ResponsesBadRequestResponseError, + ResponsesBadRequestResponseErrorData, + ) from .responsevalidationerror import ResponseValidationError from .serviceunavailableresponse_error import ( ServiceUnavailableResponseError, @@ -144,6 +148,8 @@ "RequestTimeoutResponseError", "RequestTimeoutResponseErrorData", "ResponseValidationError", + "ResponsesBadRequestResponseError", + "ResponsesBadRequestResponseErrorData", "ServiceUnavailableResponseError", "ServiceUnavailableResponseErrorData", "TooManyRequestsResponseError", @@ -205,6 +211,8 @@ "ProviderOverloadedResponseErrorData": ".provideroverloadedresponse_error", "RequestTimeoutResponseError": ".requesttimeoutresponse_error", "RequestTimeoutResponseErrorData": ".requesttimeoutresponse_error", + "ResponsesBadRequestResponseError": ".responsesbadrequestresponse_error", + "ResponsesBadRequestResponseErrorData": ".responsesbadrequestresponse_error", "ResponseValidationError": ".responsevalidationerror", "ServiceUnavailableResponseError": ".serviceunavailableresponse_error", "ServiceUnavailableResponseErrorData": ".serviceunavailableresponse_error", diff --git a/src/openrouter/errors/responsesbadrequestresponse_error.py b/src/openrouter/errors/responsesbadrequestresponse_error.py new file mode 100644 index 000000000..fbf79ff44 --- /dev/null +++ b/src/openrouter/errors/responsesbadrequestresponse_error.py @@ -0,0 +1,38 @@ +"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.""" + +from __future__ import annotations +from dataclasses import dataclass, field +import httpx +from openrouter.components import ( + responsesbadrequestresponseerrordata as components_responsesbadrequestresponseerrordata, +) +from openrouter.errors import OpenRouterError +from openrouter.types import BaseModel, OptionalNullable, UNSET +from typing import Any, Dict, Optional + + +class ResponsesBadRequestResponseErrorData(BaseModel): + error: components_responsesbadrequestresponseerrordata.ResponsesBadRequestResponseErrorData + r"""Error data for ResponsesBadRequestResponse""" + metadata: OptionalNullable[Dict[str, str]] = UNSET + r"""Validation details for string-coded errors; `raw` holds the serialized schema issues""" + openrouter_metadata: OptionalNullable[Dict[str, Any]] = UNSET + user_id: OptionalNullable[str] = UNSET + + +@dataclass(unsafe_hash=True) +class ResponsesBadRequestResponseError(OpenRouterError): + r"""Bad Request - Invalid request parameters or malformed input. Request-shape validation failures carry a Responses API string code (e.g. `invalid_prompt`) with details in the top-level `metadata`; all other failures carry the integer HTTP status.""" + + data: ResponsesBadRequestResponseErrorData = field(hash=False) + + def __init__( + self, + data: ResponsesBadRequestResponseErrorData, + raw_response: httpx.Response, + body: Optional[str] = None, + ): + fallback = body or raw_response.text + message = str(data.error.message) or fallback + super().__init__(message, raw_response, body) + object.__setattr__(self, "data", data) diff --git a/src/openrouter/responses.py b/src/openrouter/responses.py index 369de7f77..6583a0b59 100644 --- a/src/openrouter/responses.py +++ b/src/openrouter/responses.py @@ -917,9 +917,11 @@ def send( 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 + errors.ResponsesBadRequestResponseErrorData, http_res, http_res_text + ) + raise errors.ResponsesBadRequestResponseError( + response_data, 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( @@ -1929,9 +1931,11 @@ async def send_async( 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 + errors.ResponsesBadRequestResponseErrorData, http_res, http_res_text + ) + raise errors.ResponsesBadRequestResponseError( + response_data, 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( diff --git a/uv.lock b/uv.lock index caf5715fb..72c34a41c 100644 --- a/uv.lock +++ b/uv.lock @@ -231,7 +231,7 @@ wheels = [ [[package]] name = "openrouter" -version = "1.3.170" +version = "1.3.171" source = { editable = "." } dependencies = [ { name = "httpcore" },