开发者快速开始

注册并登录，在 Portal → API Keys 创建密钥并立即安全保存。明文只展示一次；只放在服务端，勿放入浏览器或客服消息。
通过 Portal → Support 联系运营确认访问条件。当前不接受充值；注册账户不代表已获得有余额的 API 访问权限。
执行 pip install openai 安装 Python SDK，在本地进程设置 AI_GATEWAY_API_KEY 和 AI_GATEWAY_BASE_URL。地址必须替换为运营确认、以 /v1 结尾的 HTTPS 端点，不要使用虚构域名。
发送一个小型非流式文本请求，在 Portal → Usage 查看 Token 与实际费用，在 Portal → Billing 查看账务记录。临时冻结与实际消费分别展示。

兼容范围仅为 POST /v1/chat/completions 和需认证的 GET /v1/models。请求字段为 model、messages、max_tokens 和 stream=false。消息只含 role 和字符串 content。额外字段会被拒绝；并非完整兼容 OpenAI 全部接口。

从一个小型文本请求开始

需要已充值账户及服务端 API Key。先安装 Python openai 包，使用前由运营确认 HTTPS API 地址；本预览尚未公布正式生产端点。

quickstart.py

import os
from openai import OpenAI

# Set AI_GATEWAY_BASE_URL to the operator-confirmed HTTPS API URL ending in /v1.
# No public production API domain has been announced yet.
client = OpenAI(
    api_key=os.environ["AI_GATEWAY_API_KEY"],
    base_url=os.environ["AI_GATEWAY_BASE_URL"],
    max_retries=0,
)
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Hello, world!"}],
    max_tokens=32,
    stream=False,
)
print(response.choices[0].message.content)
print(response.usage)

常见错误与安全恢复

401：API Key 缺失、无效或已撤销。核对密钥，但不要泄露明文。
403：密钥或客户停用、不可用，或未绑定有效客户账户。
402：可用余额不足以覆盖请求估算。请查看余额及尚未释放的冻结；当前不接受充值。
422：不支持的模型、字段、消息格式、流式设置或 max_tokens。修正后再提交。
429：请求准入或限流触发。降低并发并检查响应，不要盲目重复结果未知的请求。
5xx 或响应丢失：执行或结算结果可能未知。先核对用量、账单，并在有请求编号时提供给客服。

保留 max_retries=0。当前不保证端到端请求幂等。超时或失败响应可能仍有冻结，也可能对应已完成的调用；重复请求可能再次执行并计费，应先核实原请求结果。