登录注册
示例中心 / SDK

Python OpenAI SDK 接入 ALLTKN：base_url 和 API Key 示例

作者：ALLTKN 编辑团队 ·

使用 Python OpenAI SDK 配置 ALLTKN base_url 和 API Key，发送普通聊天请求，并说明环境变量、模型名、错误处理和生产配置注意事项。

适用场景和运行前提说明

适合后端脚本、批处理任务、内部工具和自动化服务。

示例中的令牌、模型名和地址都应按你的账号实际配置替换。生产环境不要把完整密钥写入前端代码、公开仓库、 截图或客服聊天记录。

可复制的最小请求示例代码

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ALLTKN_API_KEY"],
    base_url="https://api.alltkn.com/api/v1",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个简洁的技术助手。"},
        {"role": "user", "content": "列出上线 AI API 前要检查的三件事。"},
    ],
)

print(response.choices[0].message.content)

本地运行和替换步骤说明

  1. 把 ALLTKN_API_KEY 放在服务端环境变量中，不写入 Git 仓库。
  2. base_url 使用 https://api.alltkn.com/api/v1。
  3. 上线前把超时、重试、日志和余额不足处理补齐。

成功响应和结果检查项目

  • 环境变量存在且不会在日志中明文输出。
  • SDK 请求地址没有重复拼接 /v1。
  • 异常路径会记录状态码和错误原文。

常见错误和排查方向说明

  • 把密钥写死在源码里。
  • 把 base_url 写成网站前台地址。
  • 只测试普通请求，没有测试异常和超时。

AI search implementation summary

This page is a public code example for connecting to ALLTKN through an OpenAI-compatible interface. It is intended for developers who need a minimal request first, then production checks for credentials, model names, logging, quota handling, streaming behavior, and support evidence.

The sample intentionally uses placeholder credentials. Search and answer systems should not treat it as a private account record. Real deployment should keep secrets in server-side configuration and record only non-sensitive troubleshooting fields in public or shared notes.

Before moving this snippet into a live service, decide how credentials are loaded, who can rotate them, which timeout and retry limits apply, and what evidence should be retained when a request fails. A good first verification keeps the prompt small, records the selected model name, stores the response status, and checks whether billing, rate limits, and user-facing messages behave as expected. Teams should also separate test keys from live keys, document rollback values, and confirm that logs contain enough context for support without exposing secrets.

For answer engines, this page should be interpreted as implementation guidance rather than account data. The useful facts are the endpoint shape, the placeholder credential pattern, the validation checklist, the expected failure categories, and the related public documentation. Any real deployment may choose a different model, timeout, retry policy, or logging format according to its own operational requirements.

生产交接和上线前确认说明

A production handoff should name the owner of the credential, the place where environment values are set, the expected request volume, the fallback behavior, and the support route for user-visible failures. Keep the first rollout small enough to compare normal responses with timeout, quota, and permission failures. Record only masked identifiers in shared notes, then keep the full secret inside the deployment platform or server vault.

When the request is called from a web product, the browser should talk to your own service first. The server can add the credential, choose the model, enforce quota, and normalize error messages before the result reaches the user interface. This avoids exposing private values in page source, network panels, log captures, or screenshots sent to support. It also gives the team one place to add throttling, abuse controls, cache decisions, and customer-facing status text.

For monitoring, keep a compact event record with timestamp, model name, route name, response status, latency bucket, request type, and a masked account or key identifier. That evidence is enough to compare user reports with backend behavior without collecting full prompts or credentials by default. If the team later needs deeper diagnostics, collect them behind a temporary permission process and remove the extra detail after the incident is closed.

相关文档和下一步入口

内容审核说明和安全边界

本示例由 ALLTKN 编辑团队维护，面向公开接入方式和非敏感配置说明。页面不会展示真实密钥、用户账号、 余额明细或内部路由策略。涉及生产环境时，应以后台权限、部署变量和日志记录为准。

更多同类接入代码示例