diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock index 9a815164..be414da6 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: e408687b6809c0eb28ce2608b3c9d155 + docChecksum: b4c802a90b9a216deeaff44a52c2357a docVersion: 1.0.0 speakeasyVersion: 1.787.0 generationVersion: 2.914.0 - releaseVersion: 1.1.44 - configChecksum: 58e13146341fef6b0ea6ae8882827d37 + releaseVersion: 1.1.45 + configChecksum: 7ca5bb9842bd6cb37efcb3bbaa5b1855 repoURL: https://github.com/OpenRouterTeam/python-sdk.git installationURL: https://github.com/OpenRouterTeam/python-sdk.git published: true persistentEdits: - generation_id: f961c45e-5096-4334-bf45-ef26d2b749e8 - pristine_commit_hash: ba9a7f326ed5f0c2a84c6b81ced43935892e8629 - pristine_tree_hash: e87ac6459017910906d4f2566ca55e1cebef6340 + generation_id: b03c4396-b2bc-48aa-86c6-98130db36529 + pristine_commit_hash: fff7fca5c6ba772a88e7b2a29634d67a5e098a26 + pristine_tree_hash: cc67c4656f2f0e02d468801620f418c4922f4adf features: python: acceptHeaders: 3.0.0 @@ -2182,16 +2182,24 @@ trackedFiles: pristine_git_object: 384c9eac32dc42b655935f262e21ecd6d125dfa0 docs/components/generationcontentdata.mdx: id: 030f8930b5df - last_write_checksum: sha1:84792e91bcca8347a02d62672fa755bd7c607cbb - pristine_git_object: 1e4a22a040cc50e6700e7a2a9786e812e88435ef + last_write_checksum: sha1:8cd824dc313a2f8c1aad0e35483f8591f8614170 + pristine_git_object: 09bc28302495af1bea9c207b9389c713d99fa029 docs/components/generationcontentdataoutput.mdx: id: a86cb8cf8b22 last_write_checksum: sha1:3ddde7d4af4ff46aebf9c585f0fb4d2a4a452bea pristine_git_object: d497eb12b1565177425a3b77996c12e540110b31 + docs/components/generationcontenterror.mdx: + id: d4193c1812a5 + last_write_checksum: sha1:d841546e93c61a086ff2e3c74739e110f5c2ede1 + pristine_git_object: f6cee61d8c57fb7f98c9d79401c83c46e9b6e1cd + docs/components/generationcontenterrorattempt.mdx: + id: f52c4b75b1c6 + last_write_checksum: sha1:efab9c4c12e66bf9eb98dc1a96be1b13912471f3 + pristine_git_object: cc7ba02b5f5ab4b97b9b0b3138e39040c94d8ea9 docs/components/generationcontentresponse.mdx: id: 6961bdcaae0b - last_write_checksum: sha1:e4c7d5fcddd8c9ad181766e24a2b3b62c1cd1f5c - pristine_git_object: e214221d00eebf62201405e60c28a40d7f568e57 + last_write_checksum: sha1:6b718cc97d35a859e34cc13791ddb3811f562a66 + pristine_git_object: 8fab8bcf0f61600ace4f2d18a75ffd3864aebee4 docs/components/generationresponse.mdx: id: b3a5579b9919 last_write_checksum: sha1:95b41bf6ced0933321650bd2c4413106974766da @@ -7122,8 +7130,8 @@ trackedFiles: pristine_git_object: d9aef34c11d538fe9d54a41f27a913181cc4f1f5 docs/sdks/generations/README.mdx: id: a754fecc8514 - last_write_checksum: sha1:b5f8035c676b5eb050472ed9697b64718aed8f17 - pristine_git_object: f262b34982a18293f5ae22bfbbf385010bfcdc9c + last_write_checksum: sha1:f6c55504d8c3e5e44420db68d7864fbbae4d999a + pristine_git_object: 064751ea194bff6b8111575603f804362960b886 docs/sdks/guardrails/README.mdx: id: a0cd4218b8fa last_write_checksum: sha1:a1382f5db5f769469ee8c236eb60d5a44068bc88 @@ -7190,8 +7198,8 @@ trackedFiles: pristine_git_object: 3e38f1a929f7d6b1d6de74604aa87e3d8f010544 pyproject.toml: id: 5d07e7d72637 - last_write_checksum: sha1:18256d8b9cc609a66b10b73bc29e1f89e71a5ce1 - pristine_git_object: 2633c255582f9f232999f764a31f1a5d170c712f + last_write_checksum: sha1:c0690cb780257bb8812899d9164ad0ad80eb186a + pristine_git_object: 975fb5a58ae9ffc5ac42c92c5000484ca535fe39 scripts/prepare_readme.py: id: e0c5957a6035 last_write_checksum: sha1:77f44b60b98bc126557ec27391f91dfba764bb54 @@ -7218,8 +7226,8 @@ trackedFiles: pristine_git_object: 86713cfea633e09d33b3d4e65281071fe20e6137 src/openrouter/_version.py: id: d8d15ad6c586 - last_write_checksum: sha1:bf92de0c3824a4280f6bb520e285a00d20188ed7 - pristine_git_object: 055275608059735910d646e0ada351d41f4a6017 + last_write_checksum: sha1:5258379a3f8f8ab4a170e1a1eebca76f22071757 + pristine_git_object: ad84bcae12afe6d5fa7d04d77a6b71180dd4b275 src/openrouter/analytics.py: id: cb406b5aaabb last_write_checksum: sha1:3ea0f1c73fb9c101b7bc5719da4dd7bf62ff469a @@ -7262,8 +7270,8 @@ trackedFiles: pristine_git_object: ad3d247954547814054c01989a2dff3d12b3e4e1 src/openrouter/components/__init__.py: id: 81754e97b3f4 - last_write_checksum: sha1:7fc8366c0da24c31337bded97df0f1c8f9cdb173 - pristine_git_object: f714cc3337bfe431ca2007e9511a81d970dd4e62 + last_write_checksum: sha1:53e2861e42f8094758a01a20eba2b39a4cd1cb91 + pristine_git_object: e2409b0beded65a52ecd777135d3f040030ef699 src/openrouter/components/aabenchmarkentry.py: id: e2e0f0b48c82 last_write_checksum: sha1:fab4d9a24d2cea937bb749d46c5f83941e99d65c @@ -8218,12 +8226,20 @@ trackedFiles: pristine_git_object: cfe434755a0c8f34cc8797777eee68311dbbd243 src/openrouter/components/generationcontentdata.py: id: 0140215b5b46 - last_write_checksum: sha1:8f0b1104c944ce96fa078baf47dfd9d040828c77 - pristine_git_object: 5a777789d3ddd89f39a889cd38b3abed8af6149b + last_write_checksum: sha1:c3d877cd0fcbed4aed6e7c1956f72a799fa5b045 + pristine_git_object: 755c088a9f24a16411584f6c784bd325978aa8b1 + src/openrouter/components/generationcontenterror.py: + id: a4b33e2351b0 + last_write_checksum: sha1:043bd0da39dded8b0b8ae11964589965b08ed02a + pristine_git_object: b9f03a6bfaf00c313e7b557cf012fcb894c633fb + src/openrouter/components/generationcontenterrorattempt.py: + id: 6b708637e7ba + last_write_checksum: sha1:04adc8dda708c09164974b2bd78cd20566d82c3a + pristine_git_object: dc0f9e7b77baa4348526b87cb52311473cd3a233 src/openrouter/components/generationcontentresponse.py: id: c3f3f745a193 - last_write_checksum: sha1:0a87a329f4b565c773d730ddc74595c6a0d64ddc - pristine_git_object: b762f6507fe7c7456df88a9400f82587fd6d63c9 + last_write_checksum: sha1:efb4b4930d2b85d8f68f45256ef487c2f9d9ba76 + pristine_git_object: 5caeacf169f3edff5b6e9823264aeeff8be1e8ff src/openrouter/components/generationresponse.py: id: 84d4e3e7da8b last_write_checksum: sha1:b26bce951ba1ce6ffb0779809e4410b03d9b9e6a @@ -9790,8 +9806,8 @@ trackedFiles: pristine_git_object: 268e617de41c88c6393b791a4c04048de4d7ce3c src/openrouter/generations.py: id: 70e1c21042bc - last_write_checksum: sha1:00b190db603c57571f77ccfe5d5612a3f42c62a0 - pristine_git_object: f6dbf5440466ba6b1d92442cad1b91e2b3587c52 + last_write_checksum: sha1:a8679c263af864e94aa0b33e6a8505e66b4c4047 + pristine_git_object: d5990c4254d4b3c5dae3f548bbec02558adadae1 src/openrouter/guardrails.py: id: 705839f34e66 last_write_checksum: sha1:51cf6938e2307e3834dbeaf45e454fdbec040352 @@ -11274,7 +11290,7 @@ examples: id: "gen-1234567890" responses: "200": - application/json: {"data": {"input": {"messages": [{"content": "What is the meaning of life?", "role": "user"}]}, "output": {"completion": "The meaning of life is a philosophical question...", "reasoning": null}}} + application/json: {"data": {"error": null, "input": {"messages": [{"content": "What is the meaning of life?", "role": "user"}]}, "output": {"completion": "The meaning of life is a philosophical question...", "reasoning": null}}} "401": application/json: {"error": {"code": 401, "message": "Missing Authentication header"}} "403": @@ -12066,4 +12082,6 @@ examples: "500": application/json: {"error": {"code": 500, "message": "Internal Server Error"}} examplesVersion: 1.0.2 -releaseNotes: "## Python SDK Changes:\n* `open_router.benchmarks.get_benchmarks()`: \n * `request` **Changed**\n * `response.data[]` **Changed** (Breaking ⚠️)\n" +releaseNotes: | + ## Python SDK Changes: + * `open_router.generations.list_generation_content()`: `response.data.error` **Added** diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml index 7066bde3..61ef256d 100644 --- a/.speakeasy/gen.yaml +++ b/.speakeasy/gen.yaml @@ -36,7 +36,7 @@ generation: documentation: mintlify preApplyUnionDiscriminators: true python: - version: 1.1.44 + version: 1.1.45 additionalDependencies: dev: {} main: {} diff --git a/.speakeasy/out.openapi.yaml b/.speakeasy/out.openapi.yaml index 6244780a..631ba9a4 100644 --- a/.speakeasy/out.openapi.yaml +++ b/.speakeasy/out.openapi.yaml @@ -9151,8 +9151,9 @@ components: - 'title' type: 'object' GenerationContentData: - description: 'Stored prompt and completion content' + description: 'Stored prompt and completion content, plus the failure error when one was stored' example: + error: null input: messages: - content: 'What is the meaning of life?' @@ -9161,6 +9162,8 @@ components: completion: 'The meaning of life is a philosophical question...' reasoning: null properties: + error: + $ref: '#/components/schemas/GenerationContentError' input: anyOf: - properties: @@ -9203,11 +9206,98 @@ components: required: - 'input' - 'output' + - 'error' + type: 'object' + GenerationContentError: + description: 'The stored failure for this generation, or null when it succeeded' + example: + message: 'Timed out waiting for the provider' + previous_errors: + - code: 429 + message: 'Provider returned error' + provider_name: 'Google' + raw: '{"error":{"code":429,"message":"Resource exhausted"}}' + provider_name: 'Vertex' + raw: '{"error":{"code":504,"message":"Deadline exceeded"}}' + status: 504 + properties: + message: + description: 'Error message returned to the client' + example: 'Timed out waiting for the provider' + type: + - 'string' + - 'null' + previous_errors: + description: 'Every upstream attempt that failed before the returned error, in attempt order' + items: + $ref: '#/components/schemas/GenerationContentErrorAttempt' + type: 'array' + provider_name: + description: 'Provider whose error was returned to the client, when known' + example: 'Vertex' + type: + - 'string' + - 'null' + raw: + description: 'Raw error body behind the returned error, when stored' + example: '{"error":{"code":504,"message":"Deadline exceeded"}}' + type: + - 'string' + - 'null' + status: + description: 'HTTP status returned to the client' + example: 504 + type: + - 'integer' + - 'null' + required: + - 'status' + - 'message' + - 'provider_name' + - 'raw' + - 'previous_errors' + type: + - 'object' + - 'null' + GenerationContentErrorAttempt: + description: 'A single failed upstream attempt recorded for the generation' + example: + code: 429 + message: 'Provider returned error' + provider_name: 'Google' + raw: '{"error":{"code":429,"message":"Resource exhausted"}}' + properties: + code: + description: 'HTTP status returned by this attempt' + example: 429 + type: 'integer' + message: + description: 'Error message returned by this attempt' + example: 'Provider returned error' + type: 'string' + provider_name: + description: 'Provider that served this attempt, when known' + example: 'Google' + type: + - 'string' + - 'null' + raw: + description: 'Raw error body returned by the provider, when stored' + example: '{"error":{"code":429,"message":"Resource exhausted"}}' + type: + - 'string' + - 'null' + required: + - 'code' + - 'message' + - 'provider_name' + - 'raw' type: 'object' GenerationContentResponse: description: 'Stored prompt and completion content for a generation' example: data: + error: null input: messages: - content: 'What is the meaning of life?' @@ -30417,16 +30507,26 @@ paths: application/json: example: data: + error: + message: 'Timed out waiting for the provider' + previous_errors: + - code: 429 + message: 'Provider returned error' + provider_name: 'Google' + raw: '{"error":{"code":429,"message":"Resource exhausted"}}' + provider_name: 'Vertex' + raw: '{"error":{"code":504,"message":"Deadline exceeded"}}' + status: 504 input: messages: - content: 'What is the meaning of life?' role: 'user' output: - completion: 'The meaning of life is a philosophical question...' + completion: null reasoning: null schema: $ref: '#/components/schemas/GenerationContentResponse' - description: 'Returns the stored prompt and completion content' + description: 'Returns the stored prompt and completion content, plus the failure error when the generation failed' '401': content: application/json: @@ -30507,7 +30607,7 @@ paths: schema: $ref: '#/components/schemas/ProviderOverloadedResponse' description: 'Provider Overloaded - Provider is temporarily overloaded' - summary: 'Get stored prompt and completion content for a generation' + summary: 'Get stored prompt, completion, and error content for a generation' tags: - 'Generations' parameters: diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock index 757af635..7e82c90b 100644 --- a/.speakeasy/workflow.lock +++ b/.speakeasy/workflow.lock @@ -2,8 +2,8 @@ speakeasyVersion: 1.787.0 sources: OpenRouter API: sourceNamespace: open-router-chat-completions-api - sourceRevisionDigest: sha256:0f0480623513ea8eb6966a24c5e7ea07750f656ec7a181a95c05b0688a23e203 - sourceBlobDigest: sha256:86789908c3b9752a073bf734375a2597651a71927911c6b9470089ada3d6d255 + sourceRevisionDigest: sha256:816e23f17fb6ac302f7a907e82281ed5dea91a00943de092bc90062ddc764970 + sourceBlobDigest: sha256:fb2a15f75e22611c599bd706978add5c56a2a3cfe767e28b50cf87f027f803be tags: - latest - 1.0.0 @@ -11,10 +11,10 @@ targets: open-router: source: OpenRouter API sourceNamespace: open-router-chat-completions-api - sourceRevisionDigest: sha256:0f0480623513ea8eb6966a24c5e7ea07750f656ec7a181a95c05b0688a23e203 - sourceBlobDigest: sha256:86789908c3b9752a073bf734375a2597651a71927911c6b9470089ada3d6d255 + sourceRevisionDigest: sha256:816e23f17fb6ac302f7a907e82281ed5dea91a00943de092bc90062ddc764970 + sourceBlobDigest: sha256:fb2a15f75e22611c599bd706978add5c56a2a3cfe767e28b50cf87f027f803be codeSamplesNamespace: open-router-python-code-samples - codeSamplesRevisionDigest: sha256:96ade224222d016e3a3e25dcf397a3b3a191917caa45946af874d0f9e9cb4d91 + codeSamplesRevisionDigest: sha256:8ae3982d471f05e246e090e902923ef9c0b30e8adfc19eae33176cefa37fe19b workflow: workflowVersion: 1.0.0 speakeasyVersion: 1.787.0 diff --git a/RELEASES.md b/RELEASES.md index 72c3e00f..570be75c 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -1229,4 +1229,14 @@ Based on: ### Generated - [python v1.1.44] . ### Releases -- [PyPI v1.1.44] https://pypi.org/project/openrouter/1.1.44 - . \ No newline at end of file +- [PyPI v1.1.44] https://pypi.org/project/openrouter/1.1.44 - . + +## 2026-08-11 18:24:00 +### Changes +Based on: +- OpenAPI Doc +- Speakeasy CLI 1.787.0 (2.914.0) https://github.com/speakeasy-api/speakeasy +### Generated +- [python v1.1.45] . +### Releases +- [PyPI v1.1.45] https://pypi.org/project/openrouter/1.1.45 - . \ No newline at end of file diff --git a/docs/components/generationcontentdata.mdx b/docs/components/generationcontentdata.mdx index 1e4a22a0..09bc2830 100644 --- a/docs/components/generationcontentdata.mdx +++ b/docs/components/generationcontentdata.mdx @@ -2,12 +2,13 @@ title: "GenerationContentData" --- -Stored prompt and completion content +Stored prompt and completion content, plus the failure error when one was stored ## Fields -| Field | Type | Required | Description | -| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -| `input` | [components.InputUnion](../components/inputunion.mdx) | :heavy_check_mark: | The input to the generation — either a prompt string or an array of messages | -| `output` | [components.GenerationContentDataOutput](../components/generationcontentdataoutput.mdx) | :heavy_check_mark: | The output from the generation | \ No newline at end of file +| Field | Type | Required | Description | Example | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `error` | [Nullable[components.GenerationContentError]](../components/generationcontenterror.mdx) | :heavy_check_mark: | The stored failure for this generation, or null when it succeeded | \{
"message": "Timed out waiting for the provider",
"previous_errors": [
\{
"code": 429,
"message": "Provider returned error",
"provider_name": "Google",
"raw": "\{\"error\":\{\"code\":429,\"message\":\"Resource exhausted\"}}"
}
],
"provider_name": "Vertex",
"raw": "\{\"error\":\{\"code\":504,\"message\":\"Deadline exceeded\"}}",
"status": 504
} | +| `input` | [components.InputUnion](../components/inputunion.mdx) | :heavy_check_mark: | The input to the generation — either a prompt string or an array of messages | | +| `output` | [components.GenerationContentDataOutput](../components/generationcontentdataoutput.mdx) | :heavy_check_mark: | The output from the generation | | \ No newline at end of file diff --git a/docs/components/generationcontenterror.mdx b/docs/components/generationcontenterror.mdx new file mode 100644 index 00000000..f6cee61d --- /dev/null +++ b/docs/components/generationcontenterror.mdx @@ -0,0 +1,16 @@ +--- +title: "GenerationContentError" +--- + +The stored failure for this generation, or null when it succeeded + + +## Fields + +| Field | Type | Required | Description | Example | +| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | +| `message` | *Nullable[str]* | :heavy_check_mark: | Error message returned to the client | Timed out waiting for the provider | +| `previous_errors` | List[[components.GenerationContentErrorAttempt](../components/generationcontenterrorattempt.mdx)] | :heavy_check_mark: | Every upstream attempt that failed before the returned error, in attempt order | | +| `provider_name` | *Nullable[str]* | :heavy_check_mark: | Provider whose error was returned to the client, when known | Vertex | +| `raw` | *Nullable[str]* | :heavy_check_mark: | Raw error body behind the returned error, when stored | \{"error":\{"code":504,"message":"Deadline exceeded"}} | +| `status` | *Nullable[int]* | :heavy_check_mark: | HTTP status returned to the client | 504 | \ No newline at end of file diff --git a/docs/components/generationcontenterrorattempt.mdx b/docs/components/generationcontenterrorattempt.mdx new file mode 100644 index 00000000..cc7ba02b --- /dev/null +++ b/docs/components/generationcontenterrorattempt.mdx @@ -0,0 +1,15 @@ +--- +title: "GenerationContentErrorAttempt" +--- + +A single failed upstream attempt recorded for the generation + + +## Fields + +| Field | Type | Required | Description | Example | +| ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- | +| `code` | *int* | :heavy_check_mark: | HTTP status returned by this attempt | 429 | +| `message` | *str* | :heavy_check_mark: | Error message returned by this attempt | Provider returned error | +| `provider_name` | *Nullable[str]* | :heavy_check_mark: | Provider that served this attempt, when known | Google | +| `raw` | *Nullable[str]* | :heavy_check_mark: | Raw error body returned by the provider, when stored | \{"error":\{"code":429,"message":"Resource exhausted"}} | \ No newline at end of file diff --git a/docs/components/generationcontentresponse.mdx b/docs/components/generationcontentresponse.mdx index e214221d..8fab8bcf 100644 --- a/docs/components/generationcontentresponse.mdx +++ b/docs/components/generationcontentresponse.mdx @@ -7,6 +7,6 @@ Stored prompt and completion content for a generation ## Fields -| Field | Type | Required | Description | Example | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `data` | [components.GenerationContentData](../components/generationcontentdata.mdx) | :heavy_check_mark: | Stored prompt and completion content | \{
"input": \{
"messages": [
\{
"content": "What is the meaning of life?",
"role": "user"
}
]
},
"output": \{
"completion": "The meaning of life is a philosophical question...",
"reasoning": null
}
} | \ No newline at end of file +| Field | Type | Required | Description | Example | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `data` | [components.GenerationContentData](../components/generationcontentdata.mdx) | :heavy_check_mark: | Stored prompt and completion content, plus the failure error when one was stored | \{
"error": null,
"input": \{
"messages": [
\{
"content": "What is the meaning of life?",
"role": "user"
}
]
},
"output": \{
"completion": "The meaning of life is a philosophical question...",
"reasoning": null
}
} | \ No newline at end of file diff --git a/docs/sdks/generations/README.mdx b/docs/sdks/generations/README.mdx index f262b349..064751ea 100644 --- a/docs/sdks/generations/README.mdx +++ b/docs/sdks/generations/README.mdx @@ -10,7 +10,7 @@ Generation history endpoints ### Available Operations * [get_generation](#get_generation) - Get request & usage metadata for a generation -* [list_generation_content](#list_generation_content) - Get stored prompt and completion content for a generation +* [list_generation_content](#list_generation_content) - Get stored prompt, completion, and error content for a generation * [submit_feedback](#submit_feedback) - Submit feedback for a generation ## get_generation @@ -68,7 +68,7 @@ with OpenRouter( ## list_generation_content -Get stored prompt and completion content for a generation +Get stored prompt, completion, and error content for a generation ### Example Usage diff --git a/pyproject.toml b/pyproject.toml index 2633c255..975fb5a5 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "openrouter" -version = "1.1.44" +version = "1.1.45" 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 05527560..ad84bcae 100644 --- a/src/openrouter/_version.py +++ b/src/openrouter/_version.py @@ -3,10 +3,10 @@ import importlib.metadata __title__: str = "openrouter" -__version__: str = "1.1.44" +__version__: str = "1.1.45" __openapi_doc_version__: str = "1.0.0" __gen_version__: str = "2.914.0" -__user_agent__: str = "speakeasy-sdk/python 1.1.44 2.914.0 1.0.0 openrouter" +__user_agent__: str = "speakeasy-sdk/python 1.1.45 2.914.0 1.0.0 openrouter" try: if __package__ is not None: diff --git a/src/openrouter/components/__init__.py b/src/openrouter/components/__init__.py index f714cc33..e2409b0b 100644 --- a/src/openrouter/components/__init__.py +++ b/src/openrouter/components/__init__.py @@ -1191,6 +1191,14 @@ InputUnion, InputUnionTypedDict, ) + from .generationcontenterror import ( + GenerationContentError, + GenerationContentErrorTypedDict, + ) + from .generationcontenterrorattempt import ( + GenerationContentErrorAttempt, + GenerationContentErrorAttemptTypedDict, + ) from .generationcontentresponse import ( GenerationContentResponse, GenerationContentResponseTypedDict, @@ -3932,6 +3940,10 @@ "GenerationContentDataOutput", "GenerationContentDataOutputTypedDict", "GenerationContentDataTypedDict", + "GenerationContentError", + "GenerationContentErrorAttempt", + "GenerationContentErrorAttemptTypedDict", + "GenerationContentErrorTypedDict", "GenerationContentResponse", "GenerationContentResponseTypedDict", "GenerationResponse", @@ -6167,6 +6179,10 @@ "Input2TypedDict": ".generationcontentdata", "InputUnion": ".generationcontentdata", "InputUnionTypedDict": ".generationcontentdata", + "GenerationContentError": ".generationcontenterror", + "GenerationContentErrorTypedDict": ".generationcontenterror", + "GenerationContentErrorAttempt": ".generationcontenterrorattempt", + "GenerationContentErrorAttemptTypedDict": ".generationcontenterrorattempt", "GenerationContentResponse": ".generationcontentresponse", "GenerationContentResponseTypedDict": ".generationcontentresponse", "APIType": ".generationresponse", diff --git a/src/openrouter/components/generationcontentdata.py b/src/openrouter/components/generationcontentdata.py index 5a777789..755c088a 100644 --- a/src/openrouter/components/generationcontentdata.py +++ b/src/openrouter/components/generationcontentdata.py @@ -1,6 +1,10 @@ """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.""" from __future__ import annotations +from .generationcontenterror import ( + GenerationContentError, + GenerationContentErrorTypedDict, +) from openrouter.types import BaseModel, Nullable, UNSET_SENTINEL from pydantic import model_serializer from typing import Any, List, Union @@ -67,8 +71,10 @@ def serialize_model(self, handler): class GenerationContentDataTypedDict(TypedDict): - r"""Stored prompt and completion content""" + r"""Stored prompt and completion content, plus the failure error when one was stored""" + error: Nullable[GenerationContentErrorTypedDict] + r"""The stored failure for this generation, or null when it succeeded""" input: InputUnionTypedDict r"""The input to the generation — either a prompt string or an array of messages""" output: GenerationContentDataOutputTypedDict @@ -76,10 +82,27 @@ class GenerationContentDataTypedDict(TypedDict): class GenerationContentData(BaseModel): - r"""Stored prompt and completion content""" + r"""Stored prompt and completion content, plus the failure error when one was stored""" + + error: Nullable[GenerationContentError] + r"""The stored failure for this generation, or null when it succeeded""" input: InputUnion r"""The input to the generation — either a prompt string or an array of messages""" output: GenerationContentDataOutput r"""The output from the generation""" + + @model_serializer(mode="wrap") + def serialize_model(self, handler): + 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)) + + if val != UNSET_SENTINEL: + m[k] = val + + return m diff --git a/src/openrouter/components/generationcontenterror.py b/src/openrouter/components/generationcontenterror.py new file mode 100644 index 00000000..b9f03a6b --- /dev/null +++ b/src/openrouter/components/generationcontenterror.py @@ -0,0 +1,59 @@ +"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.""" + +from __future__ import annotations +from .generationcontenterrorattempt import ( + GenerationContentErrorAttempt, + GenerationContentErrorAttemptTypedDict, +) +from openrouter.types import BaseModel, Nullable, UNSET_SENTINEL +from pydantic import model_serializer +from typing import List +from typing_extensions import TypedDict + + +class GenerationContentErrorTypedDict(TypedDict): + r"""The stored failure for this generation, or null when it succeeded""" + + message: Nullable[str] + r"""Error message returned to the client""" + previous_errors: List[GenerationContentErrorAttemptTypedDict] + r"""Every upstream attempt that failed before the returned error, in attempt order""" + provider_name: Nullable[str] + r"""Provider whose error was returned to the client, when known""" + raw: Nullable[str] + r"""Raw error body behind the returned error, when stored""" + status: Nullable[int] + r"""HTTP status returned to the client""" + + +class GenerationContentError(BaseModel): + r"""The stored failure for this generation, or null when it succeeded""" + + message: Nullable[str] + r"""Error message returned to the client""" + + previous_errors: List[GenerationContentErrorAttempt] + r"""Every upstream attempt that failed before the returned error, in attempt order""" + + provider_name: Nullable[str] + r"""Provider whose error was returned to the client, when known""" + + raw: Nullable[str] + r"""Raw error body behind the returned error, when stored""" + + status: Nullable[int] + r"""HTTP status returned to the client""" + + @model_serializer(mode="wrap") + def serialize_model(self, handler): + 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)) + + if val != UNSET_SENTINEL: + m[k] = val + + return m diff --git a/src/openrouter/components/generationcontenterrorattempt.py b/src/openrouter/components/generationcontenterrorattempt.py new file mode 100644 index 00000000..dc0f9e7b --- /dev/null +++ b/src/openrouter/components/generationcontenterrorattempt.py @@ -0,0 +1,49 @@ +"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.""" + +from __future__ import annotations +from openrouter.types import BaseModel, Nullable, UNSET_SENTINEL +from pydantic import model_serializer +from typing_extensions import TypedDict + + +class GenerationContentErrorAttemptTypedDict(TypedDict): + r"""A single failed upstream attempt recorded for the generation""" + + code: int + r"""HTTP status returned by this attempt""" + message: str + r"""Error message returned by this attempt""" + provider_name: Nullable[str] + r"""Provider that served this attempt, when known""" + raw: Nullable[str] + r"""Raw error body returned by the provider, when stored""" + + +class GenerationContentErrorAttempt(BaseModel): + r"""A single failed upstream attempt recorded for the generation""" + + code: int + r"""HTTP status returned by this attempt""" + + message: str + r"""Error message returned by this attempt""" + + provider_name: Nullable[str] + r"""Provider that served this attempt, when known""" + + raw: Nullable[str] + r"""Raw error body returned by the provider, when stored""" + + @model_serializer(mode="wrap") + def serialize_model(self, handler): + 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)) + + if val != UNSET_SENTINEL: + m[k] = val + + return m diff --git a/src/openrouter/components/generationcontentresponse.py b/src/openrouter/components/generationcontentresponse.py index b762f650..5caeacf1 100644 --- a/src/openrouter/components/generationcontentresponse.py +++ b/src/openrouter/components/generationcontentresponse.py @@ -10,11 +10,11 @@ class GenerationContentResponseTypedDict(TypedDict): r"""Stored prompt and completion content for a generation""" data: GenerationContentDataTypedDict - r"""Stored prompt and completion content""" + r"""Stored prompt and completion content, plus the failure error when one was stored""" class GenerationContentResponse(BaseModel): r"""Stored prompt and completion content for a generation""" data: GenerationContentData - r"""Stored prompt and completion content""" + r"""Stored prompt and completion content, plus the failure error when one was stored""" diff --git a/src/openrouter/generations.py b/src/openrouter/generations.py index f6dbf544..d5990c42 100644 --- a/src/openrouter/generations.py +++ b/src/openrouter/generations.py @@ -326,7 +326,7 @@ def list_generation_content( timeout_ms: Optional[int] = None, http_headers: Optional[Mapping[str, str]] = None, ) -> components.GenerationContentResponse: - r"""Get stored prompt and completion content for a generation + r"""Get stored prompt, completion, and error content for a generation :param id: The generation ID :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings. @@ -479,7 +479,7 @@ async def list_generation_content_async( timeout_ms: Optional[int] = None, http_headers: Optional[Mapping[str, str]] = None, ) -> components.GenerationContentResponse: - r"""Get stored prompt and completion content for a generation + r"""Get stored prompt, completion, and error content for a generation :param id: The generation ID :param http_referer: The app identifier should be your app's URL and is used as the primary identifier for rankings. diff --git a/uv.lock b/uv.lock index 3ac0d57c..fa6c0c97 100644 --- a/uv.lock +++ b/uv.lock @@ -213,7 +213,7 @@ wheels = [ [[package]] name = "openrouter" -version = "1.1.44" +version = "1.1.45" source = { editable = "." } dependencies = [ { name = "httpcore" },