This release is a pre-release and may not be stable for production use.
DEVUP AI Python SDK
The official Python SDK for the DEVUP AI API, with a synchronous client,
DevupAI, and an asynchronous client, AsyncDevupAI.
Requirements
Python 3.11 or later.
Installation
pip install --pre devupai
Version 1.0.0 removes the need for --pre.
Create a client
Synchronous client:
from devupai import DevupAI
with DevupAI() as client:
print(client.base_url)
Asynchronous client:
import asyncio
from devupai import AsyncDevupAI
async def main() -> None:
async with AsyncDevupAI() as client:
print(client.base_url)
asyncio.run(main())
You can also pass the key yourself:
from devupai import DevupAI
client = DevupAI(api_key="your-api-key")
try:
print(client.base_url)
finally:
client.close()
Without a with block, call client.close() (or await client.close() for
AsyncDevupAI) when you are done. Closing a client more than once is allowed.
API key
The client takes the API key from the first of these that is set:
- The
api_keyargument. - The
DEVUP_API_KEYenvironment variable. - The
DEVUPAI_API_KEYenvironment variable. It is read only whenDEVUP_API_KEYis not set at all.
When none of them is set, or the environment variable is empty, creating the
client raises ValueError. A key that contains a line break or a NUL
character also raises ValueError.
api_key="" is allowed: the client then sends an empty key, which is useful
only for requests that do not need one.
Options
Every option is a keyword argument, and both clients take the same options.
from devupai import DevupAI
client = DevupAI(
api_key="your-api-key",
base_url="https://api.devupai.com/v1",
timeout=60.0,
max_retries=2,
default_headers={"X-Application-Name": "my-application"},
)
| Option | Type | Default | Description |
|---|---|---|---|
api_key |
str | None |
See API key | Your DEVUP AI API key. |
base_url |
str | None |
https://api.devupai.com/v1 |
DEVUP AI API base URL. A trailing / is removed. It must be an absolute http or https URL without a user name or password (ValueError otherwise). |
timeout |
float | None |
600.0 (10 minutes) |
Seconds. One limit for the whole call, retries included. The Node.js SDK takes this value in milliseconds; this SDK takes seconds. |
max_retries |
int | None |
2 |
How many times a request is sent again. See Retries. |
default_headers |
Mapping[str, str] | None |
— | Headers included in every request. |
http_client |
httpx.Client / httpx.AsyncClient |
A client the SDK creates | Your own httpx.Client (for DevupAI) or httpx.AsyncClient (for AsyncDevupAI). Only its transport, connection pool and event hooks apply: its own auth, base URL, headers, query parameters, cookies and timeouts are not used (each request takes the timeout of this client or of the call). The SDK never closes a client you pass. |
on_debug |
Callable[[DebugEvent], None] | None |
— | Receives debug events, such as retry before each retry. An exception raised in it is ignored. |
timeout must be a positive number of seconds, and max_retries a
non-negative integer. A wrong type raises TypeError and a wrong value raises
ValueError, before any request is sent.
The SDK sends User-Agent: devupai-python/<version>. It manages the
Authorization and Content-Type headers itself; custom headers cannot
override them. Redirects are not followed.
Retries
The client sends a request again, up to max_retries times (default 2), after
a 408, 429, 502, 503 or 504 answer, or a connection error.
| Requests | Sent again after |
|---|---|
| Billed requests: chat completions, Responses, embeddings, rerank, image generation and edits, audio, video, and native inference | 429 and 503, and a connection that could not be opened |
| Other requests | 408, 429, 502, 503, and 504, and connection errors |
A billed request is sent again only after a 429 or 503 answer, or when the connection could not be opened. After any other answer, or a connection lost after the request may have been sent, the error is returned to you without a retry, because the request may already have been processed and charged.
A 500 answer is not retried.
When the answer has a retry-after-ms or Retry-After header, the client
waits that long before the next attempt. Otherwise it waits a random time that
grows with each attempt, at most 60 seconds between attempts. A wait that does
not fit in the time left of timeout ends the call with the error.
max_retries=0 turns retries off.
Errors
Every error from the API is a DevupAPIError. The SDK raises the subclass
that matches the HTTP status, so you can catch a specific case or the base
class. All the classes below are subclasses of DevupAPIError.
| Class | Status | Notes |
|---|---|---|
BadRequestError |
400 | The request is not valid as sent; code names the reason. |
AuthenticationError |
401 | Missing or invalid API key. |
PaymentRequiredError |
402 | The balance does not cover the request (insufficient_balance), or a scoped credential reached its budget (budget_exhausted). |
PermissionDeniedError |
403 | The key cannot use this resource. |
NotFoundError |
404 | For example, an unknown model. |
ConflictError |
409 | The outcome of this request is not confirmed yet (request_outcome_pending). Do not send it again: contact support with request_id. |
PayloadTooLargeError |
413 | The request body is larger than the limit (payload_too_large). |
UnsupportedMediaTypeError |
415 | The model does not accept the content type of the request. Send the Content-Type and body format that the API reference lists for the endpoint. |
UnprocessableEntityError |
422 | The request was not accepted in its current form. |
RateLimitError |
429 | Read retry_after_ms for the suggested wait. |
InternalServerError |
500 and up | After a 500 or 502 the request may already have been processed and charged: check its outcome before sending it again. |
APIConnectionError |
0 |
The API could not be reached. |
APITimeoutError |
0 |
The call exceeded timeout. A subclass of APIConnectionError. |
DevupAPIError |
other | Any other status. |
| Field | Type | Description |
|---|---|---|
status |
int |
HTTP status code, or 0 for connection errors and timeouts. |
message |
str |
Human-readable error message (also str(err)). |
code |
str | None |
Machine-readable error code, when available. |
type |
str | None |
Error category, when available. |
param |
str | None |
The request parameter the error refers to, when available. |
request_id |
str | None |
The x-request-id header. Include it when you contact support. |
client_request_id |
str | None |
The x-client-request-id header. |
retry_after |
str | None |
Raw Retry-After header value. |
retry_after_ms |
float | None |
Suggested wait in milliseconds, when the answer gives one. |
warnings |
list[str] |
Notice codes from the X-DEVUP-Warnings header (empty when none). |
headers |
dict[str, str] |
Response headers, with lower-case names. |
The underlying exception, when there is one, is chained as __cause__.
A 409 means the outcome of the request is not confirmed yet. Do not send it
again: contact support with its request_id.
from devupai import DevupAPIError, RateLimitError
try:
... # a call to the DEVUP AI API
except RateLimitError as err:
print(err.retry_after_ms)
except DevupAPIError as err:
print(err.status, err.code, err.request_id)
The error codes you can act on are listed at docs.devupai.com/docs/errors.
License
The DEVUP AI Python SDK is released under the MIT License.
Metadata
Release files for devupai 1.0.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| devupai-1.0.0a1.tar.gz | 64.3 kB | With provenance | Details for devupai-1.0.0a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| devupai-1.0.0a1-py3-none-any.whl | Python 3 | none | any | Details for devupai-1.0.0a1-py3-none-any.whl |
Total release size: 149.2 kB
Release files / devupai-1.0.0a1.tar.gz
| Download URL | devupai-1.0.0a1.tar.gz |
|---|---|
| Size | 64.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
818b93dde5e5357ace4ac907d966286323f1c2c3a029c2f7f716babc566401a5
|
|
BLAKE2b-256 checksum How to use checksums |
8d2bdbe67e1d6f78700358884c952cfab4f3ab6bb7f57a1008ad905d11b3b85b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logRelease files / devupai-1.0.0a1-py3-none-any.whl
| Download URL | devupai-1.0.0a1-py3-none-any.whl |
|---|---|
| Size | 85.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
88c98c5c786f1542d589766055c07f1e1a392f73a36519a6eb92209131a197af
|
|
BLAKE2b-256 checksum How to use checksums |
901c3f10964e76fc1bfc6c80e226f5147135ffb43b1374abd90276d7b39310c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logSecurity for devupai 1.0.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for devupai-1.0.0a1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.