Skip to main content

​
Constructor

Creates a new synchronous Dedalus client instance. 
from dedalus_labs import Dedalus

client = Dedalus(
    api_key="your-api-key",
    environment="production"
)

​
Parameters

​
api_key
str | None
API key for authentication. If not provided, reads from DEDALUS_API_KEY environment variable.
​
x_api_key
str | None
Alternative API key for x-api-key header authentication. If not provided, reads from DEDALUS_X_API_KEY environment variable.
​
as_base_url
str | None
Base URL for the AS service. If not provided, reads from DEDALUS_AS_URL environment variable or defaults to https://as.dedaluslabs.ai.
​
dedalus_org_id
str | None
Organization ID for multi-tenant scenarios. If not provided, reads from DEDALUS_ORG_ID environment variable.
​
provider
str | None
Provider name for routing requests. If not provided, reads from DEDALUS_PROVIDER environment variable.
​
provider_key
str | None
Provider-specific API key. If not provided, reads from DEDALUS_PROVIDER_KEY environment variable.
​
provider_model
str | None
Provider-specific model identifier. If not provided, reads from DEDALUS_PROVIDER_MODEL environment variable.
​
environment
Literal['production', 'development']
Environment to use. Options are production (https://api.dedaluslabs.ai) or development (http://localhost:4010). Defaults to production.
​
base_url
str | httpx.URL | None
Override base URL for API requests. If not provided, uses the URL from the environment parameter or DEDALUS_BASE_URL environment variable.
​
timeout
float | Timeout | None
Request timeout in seconds. Can be a float for a simple timeout or a Timeout object for more granular control.
​
max_retries
int
default:"2"
Maximum number of retries for failed requests.
​
default_headers
Mapping[str, str] | None
Default headers to include in all requests.
​
http_client
httpx.Client | None
Custom httpx client instance. Use DefaultHttpxClient to retain default values for limits, timeout, and follow_redirects.

​
Resource accessors

The client provides access to various API resources through the following properties:

​
chat

Access chat completion endpoints. 
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

​
embeddings

Access text embedding endpoints. 
response = client.embeddings.create(
    model="text-embedding-ada-002",
    input="Your text here"
)

​
audio

Access audio processing endpoints. 
response = client.audio.transcriptions.create(
    file=open("audio.mp3", "rb"),
    model="whisper-1"
)

​
images

Access image generation and manipulation endpoints. 
response = client.images.generate(
    prompt="A beautiful sunset",
    model="dall-e-3"
)

​
ocr

Access optical character recognition endpoints. 
response = client.ocr.process(
    document={"document_url": "data:application/pdf;base64,..."},
    model="mistral-ocr"
)

​
models

Access model information endpoints. 
models = client.models.list()

​
responses

Access the OpenAI Responses API. 
response = client.responses.create(
    model="gpt-4",
    input="Hello, how are you?"
)

​
Examples

​
Basic initialization

from dedalus_labs import Dedalus

client = Dedalus(api_key="your-api-key")

​
Custom configuration

from dedalus_labs import Dedalus, Timeout

client = Dedalus(
    api_key="your-api-key",
    environment="production",
    timeout=Timeout(30.0, connect=5.0),
    max_retries=3,
    default_headers={"X-Custom-Header": "value"}
)

​
Using environment variables

import os

os.environ["DEDALUS_API_KEY"] = "your-api-key"
os.environ["DEDALUS_PROVIDER"] = "openai"

# Client will automatically read from environment variables
client = Dedalus()

​
With custom provider

client = Dedalus(
    api_key="your-api-key",
    provider="anthropic",
    provider_key="anthropic-api-key",
    provider_model="claude-3-opus"
)

Build docs developers (and LLMs) love

Get started for freeTalk to us