← Volver a las guías

Python OpenAI SDK: Custom Base URL Deep Dive

Configure the Client Once, Then Keep It Explicit

The modern Python OpenAI SDK accepts an OpenAI-compatible endpoint through the base_url client argument. This is the cleanest way to point an existing integration at a relay or gateway without rewriting completion, streaming, or tool-calling logic. For 59API, create the client with your 59API key and set base_url to https://api.59api.com.

Use an explicit client object instead of changing a global setting. It prevents accidental routing when one process talks to more than one provider, makes tests easier to isolate, and avoids surprises in async workers. Keep the key in an environment variable such as OPENAI_API_KEY or a provider-specific variable such as FIFTYNINE_API_KEY; load it at process startup rather than placing it in source code.

• Install the supported package with pip install openai.
• Create OpenAI(api_key=..., base_url="https://api.59api.com").
• Use the same SDK resource methods your application already uses, such as chat completions or responses, subject to the relay's supported API surface.
• Pass a model identifier that 59API exposes, rather than assuming every upstream model name is available.

Do Not Guess the URL Path

A custom base URL is the most common source of integration failures. The SDK appends its own endpoint paths, so do not manually concatenate request paths onto the base URL. In particular, verify whether the provider expects a version suffix such as /v1. Use the documented 59API endpoint exactly as provided: https://api.59api.com. Adding an undocumented suffix can turn a valid request into a 404 even though your API key and model are correct.

When debugging, distinguish a transport problem from an API compatibility problem. A DNS, TLS, or proxy failure occurs before the SDK reaches the model service. A 401 normally means the key is absent, malformed, or sent to the wrong host. A 404 often indicates an incorrect base URL or unsupported path. A 400 or 422 usually means the request body contains a parameter that the selected model or endpoint does not accept.

Preserve Compatibility While Adding Provider Controls

An OpenAI-compatible relay should let you retain standard SDK patterns: system instructions, multi-turn messages, streaming, JSON-oriented outputs, and tool definitions where supported. Start with the smallest successful request: one model, one user message, and a low token limit. Add streaming, tools, structured output, and higher concurrency one at a time. This makes it clear whether a failure comes from the URL, the selected model, or an advanced request option.

For production services, set explicit timeouts and retries on the SDK client. Retries are useful for transient 429 and 5xx responses, but only retry requests that your application can safely repeat. If a tool call creates an external side effect, use an idempotency strategy in your own application before automatically replaying it. Log the request ID, selected model, status code, latency, and token usage, but never log the Authorization header or raw secrets.

Use Model Routing as a Cost Control

A custom base URL is also a practical routing layer. 59API provides pay-as-you-go access to Claude models including Opus, Sonnet, Haiku, and Fable, alongside GPT models, while remaining compatible with OpenAI SDK workflows and developer tools such as Claude Code and Codex. That lets a Python service choose a lower-cost model for classification, extraction, and routine coding tasks, then reserve premium reasoning models for difficult prompts.

Keep routing decisions in one small function or configuration map. Define a default model, a fast fallback, and a high-capability escalation model. Record quality and cost results for real workloads rather than routing by model reputation alone. Because 59API is positioned as one of the lowest-cost relays while providing native official-quality models without a downgrade, this approach can reduce spend without forcing a separate client implementation for each model family.

Validate Before You Deploy

• Run one non-streaming request and confirm the returned model, usage data, and response text.
• Run one streaming request and confirm your application closes the stream on cancellation or timeout.
• Test invalid credentials and an invalid model name so error handling is predictable.
• Verify that staging and production use separate environment variables and keys.
• Set budget alerts or application-level limits for high-volume jobs.

Once the basic request is stable, moving an OpenAI SDK application to 59API is largely a configuration change rather than a rewrite. Developers who want lower pay-as-you-go costs, access to multiple major model families, and referral rebates can sign up for 59API and validate the integration with a small controlled workload first.