API Integration FAQ

Quickly find common questions about Base URL, models, streaming, clients, timeouts, and availability monitoring.

Address, Keys, and Models

Should the Base URL include /v1 or not?

For the OpenAI SDK, enter https://1zheai.com/v1; for the Anthropic SDK and Claude Code, enter https://1zheai.com. When using curl directly, fill in the full request path. Some desktop tools auto-complete the path — see the address comparison table.

I already have a ChatGPT or Claude subscription — do I still need a key from this site?

Yes. This site’s integration uses an API key created in this site’s console; consumer-grade client subscriptions and this site’s API credentials are different integration methods. The tool must also support custom providers or API addresses.

It's in the model list — why does the call still fail?

The list shows the models visible to the current key, not real-time inference success rates. You also need to verify the interface protocol, optional parameters, and upstream status — see the model query API.

Can I copy model names from other platforms as-is?

Copy the complete ID from this site’s model list. Different providers may use different prefixes, aliases, and date versions — do not guess or rename them. For migration steps, see the migration guide.

Requests and Clients

The call succeeds but I get no text?

First confirm the response protocol. Chat Completions reads choices[].message.content, Messages iterates over content text blocks, and Responses iterates over output or uses the SDK’s output_text. Tool-call responses may also contain no plain text.

Why wasn't the previous turn remembered?

Multi-turn conversations require the client to pass in history. Repeatedly using the same key does not automatically create a server-side session. Session-related extensions for Responses need to be confirmed separately — do not rely on them by default.

I received text over streaming — does that count as success?

You also need to confirm the end event or final status. Mid-stream errors, broken streams, and output truncation can all occur after some text has already been received. See streaming output for details.

Can I keep retrying after a timeout?

Not recommended. A timeout may occur after the request has already been processed. First check the call logs, then retry with a limited number of attempts, backoff, and a total wait time — avoid both the SDK and the application each performing a round of retries. See timeouts and retries.

Can I put the API key directly in the web frontend?

Do not compile keys into browser scripts or public repositories. Keep credentials on your server and call the API from there; the browser should only connect to your own backend. Environment variables in demo code are for server-side or local terminal use.

Service Status and Help

Uptime monitoring looks fine — why does the model still error?

Monitoring checks the HTTP accessibility of the official website, console, and API entry points — it does not represent the inference success rate of each model. Monitoring is deployed on the same server as the application, so it will also pause during a full machine failure; historical data accumulates from the time monitoring is enabled.

What should I prepare before contacting support?

Provide the occurrence time and time zone, client version, model ID, full request path, HTTP status code, request ID, and redacted error information. Remove keys, authentication headers, and private conversation content; you can organize the report using the troubleshooting template.